API Reference

OpenAPI Specification

The Coordinator Backend API follows the OpenAPI 2.0 (Swagger) specification.

Download Specs

• swagger.yaml - YAML format
• swagger.json - JSON format

Endpoints by Category

Authentication (/api/v1/auth)

Method	Endpoint	Description
POST	/auth/login	User login
POST	/auth/signup	User registration
POST	/auth/oauth/*	OAuth authentication

Users (/api/v1/users)

Method	Endpoint	Description
GET	/users/me	Get current user
PUT	/users/me	Update current user

Organizations (/api/v1/orgs)

Method	Endpoint	Description
GET	/orgs	List organizations
POST	/orgs	Create organization
GET	/orgs/{id}	Get organization

Chats (/api/v1/actions/chats)

Method	Endpoint	Description
GET	/actions/chats	List user chats
POST	/actions/chats	Create new chat
GET	/actions/chats/{chatID}	Get chat by ID
GET	/actions/chats/pinned	List pinned chats

Sessions (/api/v1/actions/sessions)

Method	Endpoint	Description
POST	/actions/sessions	Create session
GET	/actions/sessions/{sessionID}	Get session
GET	/actions/sessions/{sessionID}/clips	Get session clips

Response Formats

All responses are JSON. Successful responses return the requested data. Error responses follow this format:

{
  "error": "Error message description"
}

Status Codes

Code	Description
200	Success
201	Created
400	Bad Request
401	Unauthorized
404	Not Found
500	Internal Server Error
503	Service Unavailable