Sign in

Update workspace skill

Changed on

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

Changes a skill's name, description, or instructions, or turns it on or off. Send only the fields you want to change. A field you leave out, or send as null, keeps its value, and an empty body changes nothing.

Set enabled to false to stop the AI builder from using the skill without deleting it.

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 60 requests per minute, shared with the other endpoints that change 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 an owner or admin 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, and workspace API keys aren't accepted.</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>

put/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

Path parameters

skill_idstring required

ID of the skill to update. Get it from id in List workspace skills.

Request body

namestring nullable

New name. Name of the skill, up to 64 characters: lowercase letters and digits in words joined by single hyphens, such as code-review. Unique within the workspace.

descriptionstring nullable

New description. When the skill applies, up to 1024 characters. The AI builder reads it to decide when to load the skill, so say what the skill is for.

bodystring nullable

New instructions. The instructions the AI builder follows once it loads the skill, up to 15000 characters.

enabledboolean nullable

true lets the AI builder use the skill, and false stops it.

Example request

{
  "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."
}

Response

The updated skill.

idstring required

ID of the skill.

namestring required

Name of the skill.

descriptionstring required

When the skill applies.

bodystring required

The instructions the AI builder follows once it loads the skill.

enabledboolean required

Whether the AI builder can use the skill.

created_bystring required

Email of the member who created the skill.

created_datestring required

Time the skill was created, in UTC, as an ISO 8601 timestamp.

updated_datestring required

Time the skill last changed, in UTC, as an ISO 8601 timestamp.

Example response

{
  "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"
}

Changes