Complete reference for the NextCoder REST API
The NextCoder API provides programmatic access to all platform features. You can use the API to automate workflows, integrate with external systems, and build custom applications on top of NextCoder.
https://nextcoder.icu/api
All API requests require authentication via Clerk session cookies. Authentication is handled automatically when making requests from the browser.
The API is rate-limited to prevent abuse:
All API responses are returned in JSON format:
{
"id": "workspace-123",
"name": "My Workspace",
"createdAt": "2023-01-01T00:00:00.000Z",
"updatedAt": "2023-01-01T00:00:00.000Z"
}Error responses follow a consistent format:
{
"error": "Error message describing what went wrong"
}| Endpoint | Method | Description |
|---|---|---|
| /auth/session | GET | Get current user session |
| Endpoint | Method | Description |
|---|---|---|
| /workspaces | GET | List all workspaces |
| /workspaces | POST | Create a new workspace |
| /workspaces/{id} | GET | Get workspace details |
| /workspaces/{id} | PUT | Update a workspace |
| /workspaces/{id} | DELETE | Delete a workspace |
| /workspaces/{id}/deploy | POST | Deploy a workspace |
| Endpoint | Method | Description |
|---|---|---|
| /agents | GET | List all agents |
| /agents | POST | Create a new agent |
| /agents/{id} | GET | Get agent details |
| /agents/{id} | PUT | Update an agent |
| /agents/{id} | DELETE | Delete an agent |
| Endpoint | Method | Description |
|---|---|---|
| /integrations | GET | List all integrations |
| /integrations | POST | Create a new integration |
| /integrations/{id} | GET | Get integration details |
| /integrations/{id} | PUT | Update an integration |
| /integrations/{id} | DELETE | Delete an integration |
| Endpoint | Method | Description |
|---|---|---|
| /payments/checkout | POST | Create checkout session |
| /payments/webhook | POST | Handle webhook events |