> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.
# List workspace skills
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
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 builder 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.
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 refused even though this endpoint only reads, and workspace API keys aren't accepted.
The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json get /api/workspace/skills
openapi: 3.1.0
info:
title: Base44 App Management API
version: 1.0.0
servers:
- url: https://app.base44.com
security:
- PersonalAccessTokenAuth: []
paths:
/api/workspace/skills:
get:
summary: List workspace skills
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
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 builder 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.
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 refused even though this endpoint only reads, and workspace API
keys aren't accepted.
The response includes fields beyond the ones documented here.
Don't rely on undocumented response fields, as they can change at any
time.
operationId: list_workspace_skills_api_workspace_skills_get
responses:
'200':
description: The workspace's skills.
content:
application/json:
schema:
$ref: '#/components/schemas/WorkspaceSkillList'
'401':
description: Missing or invalid credentials.
'403':
description: >-
The workspace's plan doesn't include skills, your token is
read-only, or your credential can't be used on this endpoint.
'409':
description: Your workspace requires an unlocked SSO session.
'429':
description: Rate limit exceeded.
components:
schemas:
WorkspaceSkillList:
properties:
items:
items:
$ref: '#/components/schemas/WorkspaceSkillSummary'
type: array
title: Items
description: Every skill in the workspace, newest first.
example:
- created_by: dana@acme.com
created_date: '2026-08-01T09:15:00.123000Z'
description: Use when writing any user-facing copy for our apps.
enabled: true
id: 68d2a1f4c9e7b3001f2a5c88
name: brand-voice
updated_date: '2026-08-03T14:02:10.456000Z'
total:
type: integer
title: Total
description: Number of skills in `items`.
example: 1
type: object
required:
- items
- total
title: WorkspaceSkillList
WorkspaceSkillSummary:
properties:
id:
type: string
title: Id
description: ID of the skill.
example: 68d2a1f4c9e7b3001f2a5c88
name:
type: string
title: Name
description: Name of the skill.
example: brand-voice
description:
type: string
title: Description
description: When the skill applies.
example: Use when writing any user-facing copy for our apps.
enabled:
type: boolean
title: Enabled
description: Whether the AI builder can use the skill.
example: true
created_by:
type: string
title: Created By
description: Email of the member who created the skill.
example: dana@acme.com
created_date:
type: string
title: Created Date
description: Time the skill was created, in UTC, as an ISO 8601 timestamp.
example: '2026-08-01T09:15:00.123000Z'
updated_date:
type: string
title: Updated Date
description: Time the skill last changed, in UTC, as an ISO 8601 timestamp.
example: '2026-08-03T14:02:10.456000Z'
type: object
required:
- id
- name
- description
- enabled
- created_by
- created_date
- updated_date
title: WorkspaceSkillSummary
securitySchemes:
PersonalAccessTokenAuth:
type: http
scheme: bearer
description: 'Personal access token, sent as `Authorization: Bearer `.'
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.