Create and edit content types, content entries and AI-assisted content programmatically, and read your projects. The MCP server is built on these routes. ### Authentication Send an API key in the `X-API-Key` header, or the JWT access token the dashboard uses as `Authorization: Bearer <token>`. An API key acts with the role of the user who created it. `GET` requests need the key's `read` permission and every other method needs `write`. A key limited to one project receives `403` with `API_KEY_PROJECT_SCOPE` on any other project. Only the routes listed here accept an API key. Every other admin route (commerce, webhooks, integrations, AI provider settings and so on) requires a JWT. Projects are read-only through a key: it can list and fetch them, but creating, renaming or deleting a project needs a signed-in dashboard session. ### Errors Every error response has the same shape. Branch on `error.code`, never on `error.message`, whose wording can change. ```json { "error": { "code": "NOT_FOUND", "message": "Content entry not found: hello-world" } } ``` Validation failures use `VALIDATION_ERROR` and list the offending fields under `error.details`. ### Rate limits Requests are counted per API key (per client IP when no key is sent) in a fixed one-minute window. The default limit is 100 requests per minute. Beyond it the API answers `429` with a `Retry-After` header giving the seconds until the window resets.
Base URL: https://api.akorrah.com
The projects your key can access. Read-only: creating, renaming and deleting a project needs a signed-in dashboard session.
GET /api/projects — List projectsGET /api/projects/{slug} — Get a projectDefine the fields of each kind of content.
GET /api/projects/{projectSlug}/content-types — List content typesPOST /api/projects/{projectSlug}/content-types — Create a content typeGET /api/projects/{projectSlug}/content-types/{typeSlug} — Get a content typePUT /api/projects/{projectSlug}/content-types/{typeSlug} — Update a content typeDELETE /api/projects/{projectSlug}/content-types/{typeSlug} — Delete a content typeCreate, edit, publish and translate entries.
GET /api/projects/{projectSlug}/content/{typeSlug}/entries — List entriesPOST /api/projects/{projectSlug}/content/{typeSlug}/entries — Create an entryPOST /api/projects/{projectSlug}/content/{typeSlug}/entries/bulk — Run a bulk actionGET /api/projects/{projectSlug}/content/{typeSlug}/entries/semantic-search — Search entries by meaningGET /api/projects/{projectSlug}/content/{typeSlug}/entries/{id} — Get an entryPUT /api/projects/{projectSlug}/content/{typeSlug}/entries/{id} — Update an entryDELETE /api/projects/{projectSlug}/content/{typeSlug}/entries/{id} — Delete an entryPOST /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/archive — Archive an entryPOST /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/discard-draft-changes — Discard draft changesGET /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/hreflang — Preview an entry's hreflang linksGET /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/json-ld — Preview an entry's JSON-LDGET /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/open-graph — Preview an entry's Open Graph tagsPOST /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/publish — Publish an entryPOST /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/restore/{versionId} — Restore a versionPOST /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/schedule — Schedule publishingGET /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/translations — List translationsPOST /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/translations — Create a translationPOST /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/unpublish — Unpublish an entryGET /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/versions — List versionsEditorial comments on an entry.
GET /api/projects/{projectSlug}/content/{typeSlug}/entries/{entryId}/comments — List commentsPOST /api/projects/{projectSlug}/content/{typeSlug}/entries/{entryId}/comments — Add a commentBulk-load or download a content type's entries as JSON or CSV.
GET /api/projects/{projectSlug}/content/{typeSlug}/export/csv — Export as CSVGET /api/projects/{projectSlug}/content/{typeSlug}/export/json — Export as JSONPOST /api/projects/{projectSlug}/content/{typeSlug}/import/csv — Import from CSVPOST /api/projects/{projectSlug}/content/{typeSlug}/import/json — Import from JSONRewrite, translate, summarise, score and generate content. Counts against the project's AI budget.
POST /api/projects/{projectSlug}/ai/alt-text — Generate image alt textPOST /api/projects/{projectSlug}/ai/bulk/rewrite — Rewrite a field across entriesPOST /api/projects/{projectSlug}/ai/bulk/seo-suggest — Suggest SEO metadata across entriesPOST /api/projects/{projectSlug}/ai/bulk/translate — Translate a field across entriesPOST /api/projects/{projectSlug}/ai/expand — Expand textPOST /api/projects/{projectSlug}/ai/generate — Generate an entryPOST /api/projects/{projectSlug}/ai/generate-samples — Generate sample entriesPOST /api/projects/{projectSlug}/ai/live-audit — Audit a live URLPOST /api/projects/{projectSlug}/ai/rewrite — Rewrite textPOST /api/projects/{projectSlug}/ai/seo-score — Score SEOPOST /api/projects/{projectSlug}/ai/seo-suggest — Suggest SEO metadataPOST /api/projects/{projectSlug}/ai/shorten — Shorten textPOST /api/projects/{projectSlug}/ai/stream/rewrite — Rewrite text (streaming)POST /api/projects/{projectSlug}/ai/translate — Translate textPOST /api/projects/{projectSlug}/ai/variants — Generate variants