Search Agent Skills

POST

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

POST

/api/v4/agents/:agent_uuid/skills/search

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

{
  "items": [
    {
      "agent_versions": [
        "string"
      ],
      "description": "string",
      "environments": [
        "string"
      ],
      "kind": "string",
      "markdown": "string",
      "maturity": "provisional",
      "name": "string",
      "package_name": "string",
      "self_contained": true,
      "skill_id": "string",
      "source_attempt_families": 1,
      "task_family": "string",
      "tools": [
        "string"
      ],
      "trust": 0.61,
      "uuid": "string",
      "verified_applications": 6,
      "version": 1
    }
  ],
  "next_cursor": "string",
  "search_id": "string"
}

Authentication

AuthorizationApi-Key

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

Path parameters

agent_uuidstringRequired

Agent UUID

Query parameters

limitintegerOptional

Page size (maximum 20)

cursorstringOptional

Opaque page cursor

Request

Lexical query and exact applicability filters

querystringRequired

environmentslist of stringsOptional

include_markdownbooleanOptional

kindstringOptional

markdown_formatenumOptional

MarkdownFormat selects the form of inline markdown. agent (the default) returns the Skill text that an Agent needs: no evidence markers, the description only in the frontmatter, and no empty sections. full returns the stored SKILL.md with its evidence markers.

Allowed values:

task_familystringOptional

toolslist of stringsOptional

Response

itemslist of objectsOptional

next_cursorstringOptional

search_idstringOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

503

Service Unavailable Error