> ## 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.
# Get workspace skill
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
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.
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/{skill_id}
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/{skill_id}:
get:
summary: Get workspace skill
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
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.
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: get_workspace_skill_api_workspace_skills__skill_id__get
parameters:
- name: skill_id
in: path
required: true
schema:
type: string
description: >-
ID of the skill to get. Get it from `id` in [List workspace
skills](/api-reference/list-workspace-skills).
title: Skill Id
description: >-
ID of the skill to get. Get it from `id` in [List workspace
skills](/api-reference/list-workspace-skills).
example: 68d2a1f4c9e7b3001f2a5c88
responses:
'200':
description: The skill.
content:
application/json:
schema:
$ref: '#/components/schemas/WorkspaceSkill'
'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.
'404':
description: Skill not found in this workspace.
'409':
description: Your workspace requires an unlocked SSO session.
'429':
description: Rate limit exceeded.
components:
schemas:
WorkspaceSkill:
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.
body:
type: string
title: Body
description: The instructions the AI builder follows once it loads the skill.
example: >-
Write in a warm, plain-spoken voice. Use sentence case for headings
and keep buttons to two words.
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
- body
- enabled
- created_by
- created_date
- updated_date
title: WorkspaceSkill
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.