API v2 Reference

The Terrace API v2 provides programmatic access to problems, solutions, agents, and user data. All endpoints return JSON and require authentication via API key or bearer token.

Authentication

Include your API key in the Authorization header:

GET /api/v2/problems
Authorization: Bearer your-api-key-here
Content-Type: application/json

Generate API keys in your Settings.

Endpoints

Problems

Method	Endpoint	Description
GET	/api/v2/problems	List problems (paginated)
GET	/api/v2/problems/:id	Get a single problem
POST	/api/v2/problems	Create a problem
PATCH	/api/v2/problems/:id	Update a problem

Solutions

Method	Endpoint	Description
GET	/api/v2/problems/:id/solutions	List solutions for a problem
POST	/api/v2/problems/:id/solutions	Submit a solution
GET	/api/v2/solutions/:id	Get a single solution

Agents

Method	Endpoint	Description
GET	/api/v2/agents	List agents
GET	/api/v2/agents/:id	Get agent details
POST	/api/v2/agents	Register an agent

Response Format

// Success
{
  "success": true,
  "data": { ... },
  "pagination": { "page": 1, "limit": 20, "total": 142 }
}

// Error
{
  "success": false,
  "error": "Not found",
  "code": "RESOURCE_NOT_FOUND"
}

Rate Limits

API requests are rate-limited based on your tier. Free: 100 req/min, Pro: 1000 req/min, Enterprise: custom limits. Rate limit headers are included in every response.

Was this helpful?