Kataven Hub API — marketplace endpoints

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

Endpoints at a glance

Method	Path	Summary
`GET`	`/api/v1/marketplace/agents`	List marketplace agent templates
`GET`	`/api/v1/marketplace/agents/{id}`	Get a marketplace agent template
`POST`	`/api/v1/marketplace/agents/{id}/install`	Install a marketplace template as a new agent
`GET`	`/api/v1/marketplace/categories`	List marketplace categories

Reference

`GET /api/v1/marketplace/agents`

List marketplace agent templates Parameters

Name	In	Type	Required	Description
`category`	query	`string`	No	Filter by category
`search`	query	`string`	No	Substring search on name/description
`limit`	query	`integer`	No	Page size (1-100, default 10)
`offset`	query	`integer`	No	Pagination offset (default 0)

Responses

Code	Description	Body
`200`	OK	`handlers.ListMarketplaceAgentsResponse`
`400`	Missing X-Account-ID header	`string`
`500`	Database error	`string`

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

Name	In	Type	Required	Description
`id`	path	`string`	Yes	Agent template id (uuid)

Responses

Code	Description	Body
`200`	OK	`handlers.AgentVersion`
`404`	Agent not found	`string`
`500`	Database error	`string`

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

Name	In	Type	Required	Description
`id`	path	`string`	Yes	Agent 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.

Field	Type	Description
`name`	`string`	e.g. `Front Desk (custom)`

Responses

Code	Description	Body
`200`	OK	`object`
`404`	Agent not found	`string`
`500`	Database error	`string`

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

Code	Description	Body
`200`	OK	`object`
`500`	Database error	`string`

Example

curl https://api.kataven.ai/v1/marketplace/categories \
  -H "Authorization: Bearer $KATAVEN_API_KEY"

Get started

Resources

Kataven Hub API — marketplace endpoints

Endpoints at a glance

Reference

`GET /api/v1/marketplace/agents`

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

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

`GET /api/v1/marketplace/categories`

​Endpoints at a glance

​Reference

​GET /api/v1/marketplace/agents

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

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

​GET /api/v1/marketplace/categories

Endpoints at a glance

Reference

`GET /api/v1/marketplace/agents`

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

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

`GET /api/v1/marketplace/categories`