Zolt AI
API Documentation← Back to site

API Documentation

Zolt AI exposes a REST API, a board/element CRUD API, inbound and outbound webhooks, and an MCP server so external tools and automations can create content, read board data, and react to activity on your account.

Base URL

All endpoints below are relative to:

https://app.getzolt.ai

Authentication

Every endpoint on this site is authenticated with an API key, sent as a plain header on every request:

X-API-Key: ci_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Create a key from inside the app: open a business, go to Settings → API Keys, and click "Create key". The full key is shown to you exactly once at creation time — copy it somewhere safe. Only a hash of the key is ever stored, so if you lose it, revoke it and create a new one.

A key can be scoped to one specific board or to every board in the business (the default). A board-scoped key gets a 403 if used against any other board.

Rate limits

Each API key is limited to 30 requests per rolling 60-second window. The limit is tracked per key, not per IP, and is enforced across every endpoint on this site. Exceeding it returns:

429 Too Many Requests{ "error": "Rate limit exceeded. Try again shortly." }

Errors

Every error response is a JSON object with a single, human-readable error string:

{ "error": "Description of what went wrong." }

Status codes you'll see across these APIs:

400 Bad RequestMissing or invalid fields in the request body.
401 Unauthorized{ "error": "Missing or invalid X-API-Key." }
403 ForbiddenThe key isn't authorized for the business/board/resource requested.
404 Not FoundThe business, board, zone, tile, or generation doesn't exist.
429 Too Many RequestsRate limit exceeded.
502 Bad GatewayAn upstream provider (model, render, publish) call failed.

What's covered

  • REST API — generate/revise/idea/score content, render images and videos, publish to X, and schedule posts. This is the automation-friendly surface built for tools like Pabbly and Zapier.
  • Board API — list, create, update, and delete boards, zones, and tiles directly, plus a one-shot “ask this board” endpoint.
  • Webhooks — push content into a board from an external trigger, and receive signed events when a tile finishes processing or a generation completes.
  • MCP server — connect an AI agent (Claude, ChatGPT, etc.) directly to your boards over the Model Context Protocol.