skills

List mutable skills stored in an Agent workspace.

Changed on
get/api/agent/{agentName}/skill

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/agent/{agentName}/skill
  • Auth: HTTP bearer

Path parameters

agentNamestring required

Agent name.

Query parameters

limitinteger

Maximum number of items to return.

page_tokenstring

Opaque pagination token from a previous response.

sort_by'name' | 'file_count' | 'size_bytes' | 'modified_at'

Mutable skill field used to order results before pagination.

sort_order'asc' | 'desc'

Sort direction. Defaults to ascending when sort_by is set.

Headers

X-AgentZ-Workspace-IDstring

Stable Workspace ID selecting Workspace scope. Omit for Organisation scope.

Response

Paginated mutable skill summaries.

next_page_tokenstring required

Changes

  • 61dc99f5fdaeRevision changes
    • breaking

      the ////// response property's maxLength was increased from 32 to 63 for the response status

    • info

      added the new optional query request parameter sort_by

    • info

      added the new optional query request parameter sort_order

    • info

      the ////// response's property pattern was changed from ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ to ^[a-z0-9]+(-[a-z0-9]+)*$ for the status

  • f9e13a5159d6Revision changes
    • info

      added the new optional header request parameter X-AgentZ-Workspace-ID