Skip to main content
GET
/
api
/
v1
/
marketplace
/
agents
List marketplace agent templates
curl --request GET \
  --url https://api.kataven.ai/v1/api/v1/marketplace/agents \
  --header 'Authorization: <api-key>'
{
  "agent_templates": [
    {
      "agent_id": "<string>",
      "author": "<string>",
      "category": "<string>",
      "created_at": "<string>",
      "description": "<string>",
      "greeting_message": "<string>",
      "icon": "<string>",
      "id": "<string>",
      "kb_count": 123,
      "knowledge_items": [
        {
          "id": "<string>",
          "item_type": "<string>",
          "summary": "<string>",
          "tags": [
            "<string>"
          ],
          "title": "<string>"
        }
      ],
      "llm_model": "<string>",
      "name": "<string>",
      "playbooks": [
        {
          "description": "<string>",
          "display_name": "<string>",
          "name": "<string>",
          "playbook_id": "<string>",
          "tool_names": [
            "<string>"
          ],
          "triggers": [
            "<string>"
          ]
        }
      ],
      "system_prompt": "<string>",
      "tags": [
        "<string>"
      ],
      "tool_count": 123,
      "tools": [
        {
          "category": "<string>",
          "description": "<string>",
          "id": "<string>",
          "name": "<string>"
        }
      ],
      "version": "<string>",
      "voice_id": "<string>",
      "voice_provider": "<string>"
    }
  ],
  "count": 123,
  "has_next": true,
  "has_prev": true,
  "limit": 123,
  "next_offset": 123,
  "offset": 123,
  "prev_offset": 123,
  "total": 123
}

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.

Authorizations

Authorization
string
header
required

Headers

X-Account-ID
string

Tenant database. Required when using a Zitadel JWT.

Query Parameters

category
string

Filter by category

Substring search on name/description

limit
integer

Page size (1-100, default 10)

offset
integer

Pagination offset (default 0)

Response

OK

agent_templates
object[]
count
integer
has_next
boolean
has_prev
boolean
limit
integer
next_offset
integer
offset
integer
prev_offset
integer
total
integer