Create Agent Skill Version

POST

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

POST

/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.create_version(
    agent_uuid="agent_uuid",
    skill_uuid="skill_uuid",
    expected_version=1,
)

{
  "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
}

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

Request

Customer-authored Skill definition

definitionobjectRequired

expected_versionintegerRequired

Response

contractmap from strings to anyOptional

created_atstringOptional

definitionobjectOptional

markdownstringOptional

Markdown is the agent view of the Skill unless the request selects markdown_format=full.

self_containedbooleanOptional

versionintegerOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

503

Service Unavailable Error