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": {
        "aliases": [
          "string"
        ],
        "applicability": {
          "agent_versions": [
            "string"
          ],
          "citations": [
            "string"
          ],
          "models": [
            {
              "name": "string",
              "version_constraint": "string"
            }
          ]
        },
        "citations": [
          "string"
        ],
        "confidence": 1.1,
        "contraindications": [
          {
            "citations": [
              "string"
            ],
            "text": "string"
          }
        ],
        "customer_sections": [
          {
            "heading": "string",
            "markdown": "string",
            "schema_version": "string",
            "section_id": "string"
          }
        ],
        "dependencies": [
          {
            "package_name": "string",
            "version_constraint": "string"
          }
        ],
        "description": "string",
        "environments": [
          {
            "aliases": [
              "string"
            ],
            "citations": [
              "string"
            ],
            "name": "string",
            "version_constraint": "string"
          }
        ],
        "evidence": [
          {
            "attempt_family_id": "string",
            "id": "string",
            "polarity": "supporting",
            "source_id": "string",
            "source_kind": "trajectory",
            "trajectory_id": "string"
          }
        ],
        "failures": [
          {
            "condition": {
              "citations": [
                "string"
              ],
              "text": "string"
            },
            "recovery": [
              {
                "citations": [
                  "string"
                ],
                "text": "string"
              }
            ]
          }
        ],
        "invocation": {
          "conditions": [
            {
              "citations": [
                "string"
              ],
              "text": "string"
            }
          ],
          "summary": {
            "citations": [
              "string"
            ],
            "text": "string"
          }
        },
        "kind": "principle",
        "name": "string",
        "origin": "evidence_derived",
        "outputs": [
          {
            "citations": [
              "string"
            ],
            "text": "string"
          }
        ],
        "package_name": "string",
        "preconditions": [
          {
            "citations": [
              "string"
            ],
            "text": "string"
          }
        ],
        "procedure": [
          {
            "decision": {
              "citations": [
                "string"
              ],
              "text": "string"
            },
            "expected_observations": [
              {
                "citations": [
                  "string"
                ],
                "text": "string"
              }
            ],
            "instruction": {
              "citations": [
                "string"
              ],
              "text": "string"
            }
          }
        ],
        "relations": [
          {
            "citations": [
              "string"
            ],
            "kind": "composes",
            "target_package_name": "string",
            "version_constraint": "string"
          }
        ],
        "schema_version": "string",
        "success_criteria": [
          {
            "citations": [
              "string"
            ],
            "text": "string"
          }
        ],
        "task_family": "string",
        "termination_conditions": [
          {
            "citations": [
              "string"
            ],
            "text": "string"
          }
        ],
        "tools": [
          {
            "aliases": [
              "string"
            ],
            "citations": [
              "string"
            ],
            "name": "string",
            "version_constraint": "string"
          }
        ]
      },
      "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": "principle",
        "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

page_sizeintegerOptional1-100Defaults to 50

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

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