Management API reference

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

Projects

The projects your key can access. Read-only: creating, renaming and deleting a project needs a signed-in dashboard session.

  • GET /api/projects — List projects
  • GET /api/projects/{slug} — Get a project

Content Types

Define the fields of each kind of content.

  • GET /api/projects/{projectSlug}/content-types — List content types
  • POST /api/projects/{projectSlug}/content-types — Create a content type
  • GET /api/projects/{projectSlug}/content-types/{typeSlug} — Get a content type
  • PUT /api/projects/{projectSlug}/content-types/{typeSlug} — Update a content type
  • DELETE /api/projects/{projectSlug}/content-types/{typeSlug} — Delete a content type

Content Entries

Create, edit, publish and translate entries.

  • GET /api/projects/{projectSlug}/content/{typeSlug}/entries — List entries
  • POST /api/projects/{projectSlug}/content/{typeSlug}/entries — Create an entry
  • POST /api/projects/{projectSlug}/content/{typeSlug}/entries/bulk — Run a bulk action
  • GET /api/projects/{projectSlug}/content/{typeSlug}/entries/semantic-search — Search entries by meaning
  • GET /api/projects/{projectSlug}/content/{typeSlug}/entries/{id} — Get an entry
  • PUT /api/projects/{projectSlug}/content/{typeSlug}/entries/{id} — Update an entry
  • DELETE /api/projects/{projectSlug}/content/{typeSlug}/entries/{id} — Delete an entry
  • POST /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/archive — Archive an entry
  • POST /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/discard-draft-changes — Discard draft changes
  • GET /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/hreflang — Preview an entry's hreflang links
  • GET /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/json-ld — Preview an entry's JSON-LD
  • GET /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/open-graph — Preview an entry's Open Graph tags
  • POST /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/publish — Publish an entry
  • POST /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/restore/{versionId} — Restore a version
  • POST /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/schedule — Schedule publishing
  • GET /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/translations — List translations
  • POST /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/translations — Create a translation
  • POST /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/unpublish — Unpublish an entry
  • GET /api/projects/{projectSlug}/content/{typeSlug}/entries/{id}/versions — List versions

Comments

Editorial comments on an entry.

  • GET /api/projects/{projectSlug}/content/{typeSlug}/entries/{entryId}/comments — List comments
  • POST /api/projects/{projectSlug}/content/{typeSlug}/entries/{entryId}/comments — Add a comment

Import & Export

Bulk-load or download a content type's entries as JSON or CSV.

  • GET /api/projects/{projectSlug}/content/{typeSlug}/export/csv — Export as CSV
  • GET /api/projects/{projectSlug}/content/{typeSlug}/export/json — Export as JSON
  • POST /api/projects/{projectSlug}/content/{typeSlug}/import/csv — Import from CSV
  • POST /api/projects/{projectSlug}/content/{typeSlug}/import/json — Import from JSON

AI Assist

Rewrite, translate, summarise, score and generate content. Counts against the project's AI budget.

  • POST /api/projects/{projectSlug}/ai/alt-text — Generate image alt text
  • POST /api/projects/{projectSlug}/ai/bulk/rewrite — Rewrite a field across entries
  • POST /api/projects/{projectSlug}/ai/bulk/seo-suggest — Suggest SEO metadata across entries
  • POST /api/projects/{projectSlug}/ai/bulk/translate — Translate a field across entries
  • POST /api/projects/{projectSlug}/ai/expand — Expand text
  • POST /api/projects/{projectSlug}/ai/generate — Generate an entry
  • POST /api/projects/{projectSlug}/ai/generate-samples — Generate sample entries
  • POST /api/projects/{projectSlug}/ai/live-audit — Audit a live URL
  • POST /api/projects/{projectSlug}/ai/rewrite — Rewrite text
  • POST /api/projects/{projectSlug}/ai/seo-score — Score SEO
  • POST /api/projects/{projectSlug}/ai/seo-suggest — Suggest SEO metadata
  • POST /api/projects/{projectSlug}/ai/shorten — Shorten text
  • POST /api/projects/{projectSlug}/ai/stream/rewrite — Rewrite text (streaming)
  • POST /api/projects/{projectSlug}/ai/translate — Translate text
  • POST /api/projects/{projectSlug}/ai/variants — Generate variants