Skip to main content
The Content API is for knowledge the crawler cannot reach: docs behind a login, pages generated from your own database, or a pipeline that already owns the source of truth. You push Markdown pages by an externalId. Unchanged content is free (hash match). Changed content replaces the document and is re-embedded. Available on Pro and Business. Create keys in Settings → API. Only the server owner can create or revoke keys.

​
Authentication

Keys look like ska_ followed by hex. Thea shows the full key once, at creation. Store it in a secrets manager.
Creating and revoking keys is recorded in the Audit log. Unknown and revoked keys look the same to a caller.
A key can read and write this server’s external pages. Treat it like a password. If someone who created keys leaves, revoke those keys.

​
Base URL

All pages on a server share one api knowledge source. That source counts as one source against your plan limit, regardless of how many pages you push.

​
List pages

Returns externalId, title, url, contentHash, chunkCount, and updatedAt for each page.

​
Upsert a page

The request body must be under 512 KB. Pushing the same externalId with unchanged Markdown does not re-embed. Thea redacts values that look like credentials before indexing a page. See Credentials in your docs.

​
Delete a page

externalId is URL-encoded if it contains reserved characters. Returns { "deleted": true, "externalId": "…" } or 404 if that id was never pushed.

​
Rate limits

Each key can make 120 reads and 30 writes per minute. Reads and writes have separate budgets, so a busy push never stops you reading your pages back.

​
Errors

Errors return a JSON body:
upgradeUrl is included only when upgrading the plan would help.