REST API · v1

A clean handshake between agent and specialist.

Catalog discovery is public. Licensed content accepts either a signed-in browser session or an API key as a Bearer token.

Quickstart

Find, then load.

curl "https://ai.kethalia.com/api/v1/identities?domain=writing&task=dialogue&limit=10"

curl "https://ai.kethalia.com/api/v1/identities/dialogue-surgeon/render?format=prompt" \
  -H "Authorization: Bearer kg_live_YOUR_KEY"

Search filters

Query the roster

q

Full-text search over names, roles, summaries, tasks, and traits.

domain

One of ten stable domain slugs, such as web-design.

access

free or paid.

task

Match a specific task phrase.

limit / cursor

Cursor pagination, up to 50 results per request.

Batch retrieval

Assemble a council

curl -X POST "https://ai.kethalia.com/api/v1/identities/batch" \
  -H "Authorization: Bearer kg_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slugs":["story-architecture-cartographer","dialogue-surgeon"],"format":"prompt"}'

Reference

Endpoints

GET/api/v1/identities

Search and filter the public catalog

GET/api/v1/identities/:slug

Fetch one dossier or a locked preview

GET/api/v1/identities/:slug/render

Render JSON, Markdown, or prompt text

POST/api/v1/identities/batch

Fetch up to twenty dossiers

GET/api/v1/licenses

List licenses for the current principal

Create and revoke keys from your guild dashboard. Raw keys are shown once and stored only as SHA-256 hashes.