List Agent Skills

POST

https://api.getzep.com/api/v4/agents/:agent_uuid/skills/list

POST

/api/v4/agents/:agent_uuid/skills/list

from zep_cloud import Zep
client = Zep(
    api_key="YOUR_API_KEY_HERE",
)
client.agent.skill.list(
    agent_uuid="agent_uuid",
)

{
  "items": [
    {
      "agent_versions": [
        "2026.09.01"
      ],
      "description": "Refund a duplicate charge after you confirm the duplicate payment.",
      "environments": [
        "production"
      ],
      "kind": "procedure",
      "markdown": "Confirm the duplicate charge before issuing a refund.",
      "maturity": "provisional",
      "name": "Refund a duplicate charge",
      "package_name": "payments",
      "self_contained": false,
      "short_id": "6a906e70",
      "skill_id": "refund-duplicate-charge",
      "source_attempt_families": 1,
      "task_family": "support/refund",
      "tools": [
        "refund_payment"
      ],
      "trust": 0.61,
      "uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa",
      "verified_applications": 6,
      "version": 1
    }
  ],
  "next_cursor": "string",
  "total_size": 1
}

List Agent Skills. Agent Skills is in closed release. Zep enables Agent Skills only for select accounts. A request from an account without access returns 403 permission_denied. To get access, contact support@getzep.com.

Authentication

AuthorizationApi-Key

Type “Api-Key” followed by a space and the project API key.

Path parameters

agent_uuidstringRequired

Agent UUID

Query parameters

page_sizeintegerOptional1-20Defaults to 5

The maximum number of items in one page. The SDK method returns a pager. In Python, .items holds only the first page. In TypeScript, .data holds only the first page. To read every page, iterate the pager: use for or list(...) in Python, or for await in TypeScript. In Go, the method returns one page, and Iterator() reads all pages.

cursorstringOptional

Opaque page cursor

Request

Exact applicability filters

environmentslist of stringsOptional

The developer filters results by environment names.

kindstringOptional

The developer supplies a Skill kind.

task_familystringOptional

The developer supplies the task-family slug.

toolslist of stringsOptional

The developer supplies tool names used by the Skill.

Response

itemslist of objectsOptional

next_cursorstringOptional

total_sizeintegerOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

503

Service Unavailable Error