---
title: "List workspace skills"
method: GET
path: "/api/workspace/skills"
---

# List workspace skills

`GET /api/workspace/skills`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/workspace/skills`
- 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 every skill in a workspace, newest first, without their instructions. The list isn't paginated. A workspace has at most 100 skills. Get a skill's instructions with [Get workspace skill](/api-reference/get-workspace-skill).

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.

The AI sees the name and description of every enabled skill in the workspace, and loads a skill's instructions when its description fits the task.

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

This is limited to 120 requests per minute, shared with [Get workspace skill](/api-reference/get-workspace-skill). 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>

## Response `200`

The workspace's skills.

- WorkspaceSkillList
  - `items` WorkspaceSkillSummary[], required: Every skill in the workspace, newest first.
    - `id` string, required: ID of the skill.
    - `name` string, required: Name of the skill.
    - `description` string, required: When the skill applies.
    - `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.
  - `total` integer, required: Number of skills in `items`.

## 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.
- `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/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)