List Agent Skill Versions

GET

https://api.getzep.com/api/v4/agents/:agent_uuid/skills/:skill_uuid/versions

GET

/api/v4/agents/:agent_uuid/skills/:skill_uuid/versions

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

{
  "items": [
    {
      "contract": {},
      "created_at": "string",
      "definition": {
        "agent_versions": [
          "string"
        ],
        "aliases": [
          "string"
        ],
        "description": "string",
        "do_not_use_when": [
          "string"
        ],
        "done_when": [
          "string"
        ],
        "environments": [
          {
            "aliases": [
              "string"
            ],
            "name": "string",
            "version": "string"
          }
        ],
        "failures": [
          {
            "recover": [
              "string"
            ],
            "when": "string"
          }
        ],
        "kind": "string",
        "name": "string",
        "outputs": [
          "string"
        ],
        "package_name": "string",
        "preconditions": [
          "string"
        ],
        "procedure": [
          {
            "decision": "string",
            "expect": [
              "string"
            ],
            "instruction": "string"
          }
        ],
        "related_skills": [
          {
            "relation": "string",
            "skill": "string",
            "version": "string"
          }
        ],
        "sections": [
          {
            "heading": "string",
            "id": "string",
            "markdown": "string"
          }
        ],
        "stop_when": [
          "string"
        ],
        "task_family": "string",
        "tools": [
          {
            "aliases": [
              "string"
            ],
            "name": "string",
            "version": "string"
          }
        ],
        "use_when": [
          "string"
        ]
      },
      "markdown": "string",
      "self_contained": true,
      "version": 1
    }
  ],
  "next_cursor": "string",
  "total_size": 1
}

Authentication

AuthorizationApi-Key

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

Path parameters

agent_uuidstringRequired

Agent UUID

skill_uuidstringRequired

Skill UUID

Query parameters

limitintegerOptional

Page size (maximum 100)

cursorstringOptional

Opaque page cursor

markdown_formatenumOptional

Markdown form: agent (default) or full

Allowed values:

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