List available AI models
Returns every model Eddytor can call, grouped by provider, with the API identifier to pass as the `model` field in Magic Dust requests. Each model is tagged with the default use cases it serves (`general`, `fast`, `complex`). This is a static catalog — it does not depend on which providers you have configured (see `GET /v1/ai/credentials` for that). **Required scope:** `ai:read`
Authorization
BearerAuth Security scheme for OpenAPI endpoints. Validates both JWT tokens and API keys.
In: header
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/ai/models"{ "providers": [ { "provider": "claude", "configured": true, "models": [ { "id": "string", "default_for": [ "string" ] } ] } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}Delete an AI credential
Permanently removes the stored API key for the given provider. Any subsequent Magic Dust requests that require this provider will fail until a new credential is stored. **Required scope:** `ai:write`
List available scopes
Returns all scope presets and granular scopes available to the authenticated user's role and seat type. Use this to populate the scope picker when creating API keys. **Required scope:** `apikeys:read`