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

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

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