Sign in

v1

latestOpenAPI 3.0.02026-07-26870415.2 KB
skills

List workspace agent skills

Returns cursor-paginated workspace agent skills. Sidebar/global-assistant skills are not included in this API.

get/v1/skills

Query parameters

workspace_idstring required

Workspace to query.

Example:j57demo8f8x7c9v0n2q4r6t8y1u3i5o
limitinteger
cursorstring

Response

Workspace skills

next_cursorstring nullable required
has_moreboolean required

Example response

{
  "data": [
    {
      "id": "ks77c0dy0mgdpzmqz6tesry8w184002s",
      "workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
      "name": "booking-policy",
      "description": "Use this skill for refund and cancellation questions.",
      "body": "Guests may cancel up to 48 hours before check-in for a full refund.",
      "allowed_tools": [
        "convex_get_booking"
      ],
      "tags": [
        "policy",
        "refunds"
      ],
      "enabled": true,
      "created_at": "2026-04-01T17:22:10.000Z",
      "updated_at": "2026-04-03T03:14:15.000Z"
    }
  ],
  "next_cursor": "page-token",
  "has_more": true
}