Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kataven.ai/llms.txt

Use this file to discover all available pages before exploring further.

Browse and install pre-built agent templates. Wrapped by the Python SDK and Node SDK.

​
Endpoints at a glance

MethodPathSummary
GET/api/v1/marketplace/agentsList marketplace agent templates
GET/api/v1/marketplace/agents/{id}Get a marketplace agent template
POST/api/v1/marketplace/agents/{id}/installInstall a marketplace template as a new agent
GET/api/v1/marketplace/categoriesList marketplace categories

​
Reference

​
GET /api/v1/marketplace/agents

List marketplace agent templates Parameters
NameInTypeRequiredDescription
categoryquerystringNoFilter by category
searchquerystringNoSubstring search on name/description
limitqueryintegerNoPage size (1-100, default 10)
offsetqueryintegerNoPagination offset (default 0)
Responses
CodeDescriptionBody
200OKhandlers.ListMarketplaceAgentsResponse
400Missing X-Account-ID headerstring
500Database errorstring
Example 
curl https://api.kataven.ai/v1/marketplace/agents \
  -H "Authorization: Bearer $KATAVEN_API_KEY"

​
GET /api/v1/marketplace/agents/{id}

Get a marketplace agent template Returns the full template — system prompt, voice config, attached tools and playbooks. Parameters
NameInTypeRequiredDescription
idpathstringYesAgent template id (uuid)
Responses
CodeDescriptionBody
200OKhandlers.AgentVersion
404Agent not foundstring
500Database errorstring
Example 
curl https://api.kataven.ai/v1/marketplace/agents/agent_01HZ2N... \
  -H "Authorization: Bearer $KATAVEN_API_KEY"

​
POST /api/v1/marketplace/agents/{id}/install

Install a marketplace template as a new agent Creates a new agent in the caller’s account from the template, copying its prompts, voice config, attached playbooks and FAQs. Optionally renames it. Parameters
NameInTypeRequiredDescription
idpathstringYesAgent template id (uuid)
Request body (application/json) Schema: handlers.InstallTemplateRequest. Server-set fields (id, created_at, updated_at, …) are ignored if supplied; only the user-settable fields are shown below.
FieldTypeDescription
namestringe.g. Front Desk (custom)
Responses
CodeDescriptionBody
200OKobject
404Agent not foundstring
500Database errorstring
Example 
curl https://api.kataven.ai/v1/marketplace/agents/agent_01HZ2N.../install \
  -X POST \
  -H "Authorization: Bearer $KATAVEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Front Desk (custom)"
}'

​
GET /api/v1/marketplace/categories

List marketplace categories Returns the set of category labels that have at least one published marketplace template, with counts. Responses
CodeDescriptionBody
200OKobject
500Database errorstring
Example 
curl https://api.kataven.ai/v1/marketplace/categories \
  -H "Authorization: Bearer $KATAVEN_API_KEY"