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&profile=task" \
  -H "Authorization: Bearer kg_live_YOUR_KEY"

For compatibility, omitting profile still requests task. That alias is deprecated and resolves to kernel+method when a validated runtime package is available. New integrations should request an explicit profile.

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.

Progressive disclosure

Load only the depth the task needs

card

Public, compact discovery metadata and availability signals.

kernel

A compact interaction identity: bounded tendencies, behavior under pressure, recovery behavior, and voice constraints.

method

Domain expertise, execution method, operating contracts, and safety boundaries.

full

Kernel, method, and the deep runtime dossier, including the causal formative history, psychology, voice, collaboration model, and domain judgment.

task

Deprecated compatibility alias for kernel+method. Method instructions take precedence over kernel behavior.

Pass profile to detail, render, or batch retrieval. Catalog cards publish availableProfiles. Retrieval responses distinguish requestedProfile from resolvedProfile and include the profile contract version, source persona SHA-256, projection SHA-256, and UTF-8 byte length. An unavailable projection resolves to card with an explicit fallbackReason; clients never need to infer a fallback.

Cards are public. Every non-card profile of a paid identity requires that identity's license. Runtime projections are compiled without evaluation scenarios, scoring criteria, attestations, raw authoring provenance, or internal resources—even in the full profile.

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","profile":"method"}'

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, prompt text, or Agent SKILL.md

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.