<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns a skill with its instructions.

Skills belong to the workspace your credential is for. With a personal access token, that's the token's workspace, and there's no parameter to choose another one.

Skills need the Builder plan or higher. Below it, this returns a 403.

This is limited to 120 requests per minute, shared with List workspace skills. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit.

<Note>Call this as any member of the workspace, with a personal access token sent as a Bearer token, or from a signed-in session. A read-only token is accepted, but workspace API keys aren't.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

{
  "id": "68d2a1f4c9e7b3001f2a5c88",
  "name": "brand-voice",
  "description": "Use when writing any user-facing copy for our apps.",
  "body": "Write in a warm, plain-spoken voice. Use sentence case for headings and keep buttons to two words.",
  "enabled": true,
  "created_by": "dana@acme.com",
  "created_date": "2026-08-01T09:15:00.123000Z",
  "updated_date": "2026-08-03T14:02:10.456000Z"
}