List Skills

List the skills the caller can see.

GET /api/v1/skills

cURL

curl "https://api.wordsmith.ai/api/v1/skills?query=NDA" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "items": [
    {
      "id": "5f0d2c1e-8a47-4b6e-9c31-2d7e4a9b6f10",
      "name": "nda-review",
      "description": "Review an inbound NDA against our standard positions.",
      "visibility": "private",
      "editable": true,
      "url": "https://app.wordsmith.ai/skills/new?mode=edit&skillId=5f0d2c1e-8a47-4b6e-9c31-2d7e4a9b6f10",
      "created_at": "2026-10-19T09:12:04Z",
      "updated_at": "2026-10-19T09:12:04Z"
    }
  ],
  "cursor": null
}

Lists the skills the caller can see, the same list as the Skills page in the Wordsmith app. A skill is a set of instructions the Wordsmith agent follows when a request matches its description, with files such as references and scripts.

The list holds the caller’s own skills, skills shared with them, their organisation’s skills, and the public and community skills from Wordsmith. Skills come back sorted by name. Read one in full with Get Skill.

Authentication

Requires an API key, or an OAuth token with skills:read.

Query parameters

query · string

Only skills whose name or description contains this text.

visibility · string

Only skills with this visibility: private, customer, public or community.

cursor · string

The cursor from the previous page.

limit · integer · default: "50"

Skills per page, up to 100.

Response

Returns 200 with a page of skills.

visibility · string

private for the caller’s own skills and skills shared with them, customer for the organisation’s, public for Wordsmith’s and community for community skills.

editable · boolean

Whether the caller can change the skill with Update Skill. Public and community skills are never editable.

url · string

The skill in the Wordsmith app: its editor when the caller can change it, otherwise the Skills page. Opening it needs a Wordsmith sign-in.

cURL

curl "https://api.wordsmith.ai/api/v1/skills?query=NDA" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "items": [
    {
      "id": "5f0d2c1e-8a47-4b6e-9c31-2d7e4a9b6f10",
      "name": "nda-review",
      "description": "Review an inbound NDA against our standard positions.",
      "visibility": "private",
      "editable": true,
      "url": "https://app.wordsmith.ai/skills/new?mode=edit&skillId=5f0d2c1e-8a47-4b6e-9c31-2d7e4a9b6f10",
      "created_at": "2026-10-19T09:12:04Z",
      "updated_at": "2026-10-19T09:12:04Z"
    }
  ],
  "cursor": null
}

Errors

Status	error_code	When
400	bad_request	visibility is not one of the four values, limit is out of range, or cursor is not one this API returned.