---
title: "Get workspace skill"
method: GET
path: "/api/workspace/skills/{skill_id}"
---

# Get workspace skill

`GET /api/workspace/skills/{skill_id}`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/workspace/skills/{skill_id}`
- Auth: HTTP bearer

<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](/api-reference/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>

## Path parameters

- `skill_id` string, required: ID of the skill to get. Get it from `id` in [List workspace skills](/api-reference/list-workspace-skills).

## Response `200`

The skill.

- WorkspaceSkill
  - `id` string, required: ID of the skill.
  - `name` string, required: Name of the skill.
  - `description` string, required: When the skill applies.
  - `body` string, required: The instructions the AI follows once it loads the skill.
  - `enabled` boolean, required: Whether the AI can use the skill.
  - `created_by` string, required: Email of the member who created the skill.
  - `created_date` string, required: Time the skill was created, in UTC, as an ISO 8601 timestamp.
  - `updated_date` string, required: Time the skill last changed, in UTC, as an ISO 8601 timestamp.

## Other responses

- `401`: Missing or invalid credentials.
- `403`: The workspace's plan doesn't include skills, or your credential can't be used on this endpoint.
- `404`: Skill not found in this workspace.
- `409`: Your workspace requires an unlocked SSO session.
- `429`: Rate limit exceeded.

## Changes

- **2026-10-13** `06cfcce0bdd9`: 2 info
  - the security scope `read_only` was added to the endpoint's security scheme `PersonalAccessTokenAuth`
  - the security scope `full_access` was removed from the endpoint's security scheme `PersonalAccessTokenAuth`
- **2026-10-11** `80287813ab84`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-10-10** `fc604cdcc3a2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/idealspot/apis/base44-app-management-api/changes/api/workspace/skills/:skill_id/get.md)

---

[API](https://skmtc.dev/idealspot/apis/base44-app-management-api.md) - [All operations](https://skmtc.dev/idealspot/apis/base44-app-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/idealspot/apis/base44-app-management-api/revisions/b5b4ebd82a1e?raw)