Endpoints
Endpoint map for the Epismo HTTP API.
Protected /v1 endpoints require Authorization: Bearer <token> unless noted. Many endpoints also accept workspaceId as a query parameter to run in a specific workspace; see Authentication.
Core API
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/credits |
Get credit balance |
| POST | /v1/credits |
Start credit checkout |
| GET | /v1/workspaces |
List accessible workspaces |
| POST | /v1/workspaces |
Create a workspace |
| PATCH | /v1/workspaces/:workspaceId |
Update workspace settings |
| POST | /v1/workspaces/:workspaceId/checkout |
Get workspace checkout URL |
| GET | /v1/workspaces/:workspaceId/members |
List workspace members |
| PUT | /v1/workspaces/:workspaceId/members |
Add or update workspace members |
| DELETE | /v1/workspaces/:workspaceId/members |
Remove workspace members in bulk |
| DELETE | /v1/workspaces/:workspaceId/members/:userId |
Remove one workspace member |
| GET | /v1/projects |
List workspace projects |
| POST | /v1/projects |
Create a project |
| PATCH | /v1/projects/:projectId |
Update a project |
| DELETE | /v1/projects/:projectId |
Delete a project |
| POST | /v1/projects/members/list |
List members across project IDs |
| PUT | /v1/projects/:projectId/members |
Add project members |
| DELETE | /v1/projects/:projectId/members |
Remove project members in bulk |
| DELETE | /v1/projects/:projectId/members/:userId |
Remove one project member |
| GET | /v1/agents |
List agent catalog and active agents |
| PUT | /v1/agents |
Add agents to the active roster |
| DELETE | /v1/agents |
Remove agents from the active roster |
| POST | /v1/tracks |
Create a task or goal |
| GET | /v1/tracks/:id |
Get one track |
| PATCH | /v1/tracks/:id |
Update one track |
| POST | /v1/tracks/review |
Generate a read-only review |
| DELETE | /v1/tracks/:id |
Delete one track |
| POST | /v1/tracks/search |
Search tracks |
| POST | /v1/tracks/apply |
Bulk apply track upserts/deletes |
| POST | /v1/logs |
Append a log to a track |
| GET | /v1/logs |
List logs for one track or across visible tracks |
| DELETE | /v1/logs/:logId |
Delete one log |
| POST | /v1/packs |
Create a pack |
| GET | /v1/packs?reference=<ref> |
Read a pack by reference |
| PATCH | /v1/packs?reference=<ref> |
Update a pack by reference |
| DELETE | /v1/packs?reference=<ref> |
Delete a pack by reference |
| POST | /v1/packs/search |
Search packs |
| POST | /v1/packs/like |
Like or unlike a pack |
| POST | /v1/packs/rate |
Rate whether a pack worked |
| POST | /v1/packs/run |
Expand a workflow pack into a goal and tasks |
| PUT | /v1/aliases |
Create or repoint an alias |
| GET | /v1/aliases |
Get one alias or list aliases |
| DELETE | /v1/aliases/:alias |
Delete an alias |
| POST | /v1/suggestions |
Create a pack suggestion |
| POST | /v1/suggestions/search |
List/search suggestions |
| GET | /v1/suggestions/:id |
Read one suggestion |
| PATCH | /v1/suggestions/:id |
Update a suggestion's title/content |
| PATCH | /v1/suggestions/:id/resolve |
Resolve a suggestion status |
| POST | /v1/mcp/tokens |
Issue an MCP token |
| POST | /v1/mcp/tokens/refresh |
Refresh an MCP token |
| POST | /v1/cli/tokens |
Issue a CLI token |
Sign-in and OAuth
| Method | Path | Purpose |
|---|---|---|
| POST | /v1/otp-tokens |
Create an OTP token for sign-in |
| POST | /oauth/token |
Exchange an authorization code or refresh token for tokens |
| GET/POST | /oauth/userinfo |
OpenID Connect user info |
| POST | /oauth/register |
Dynamic client registration |
| POST | /oauth/revoke |
Revoke an access or refresh token |
| POST | /oauth/introspect |
Inspect token activity and scopes |
| GET | /.well-known/oauth-authorization-server |
OAuth authorization server metadata |
| GET | /.well-known/openid-configuration |
OpenID Connect provider metadata |
Compatibility paths
These routes remain available for older clients. Prefer the canonical routes above for new integrations.
| Method | Path | Compatibility behavior |
|---|---|---|
| PUT | /v1/workspaces |
Deprecated workspace upsert shape |
| PUT | /v1/projects |
Deprecated project upsert shape |
| PUT | /v1/tracks |
Deprecated track upsert shape |
| GET/PATCH/DELETE | /v1/packs/:id |
Legacy pack reference in the path |
| POST/GET/PATCH | /v1/packs/suggestions... |
Legacy suggestion paths, equivalent to /v1/suggestions... |