admin

Update a workspace team skill

Changes the name, description or instructions of one instruction skill the workspace wrote and shared with the whole team. A field you leave out keeps its current value. instructions replaces the whole text. Changed content is saved as a new version, and the team moves to it in the same request. A skill that is on uses the change in later runs. A paused or stopped skill stays as it is. Refused when someone saves the skill at the same time; repeat the call to apply your change to the latest version. Patricia's own skills and other kinds of workspace skill cannot be changed here. changed is false when nothing differs. The change is recorded against your staff account in the workspace audit log and the platform audit log.

patch/v1/admin/tenants/{tenant_id}/team-skills/{skill_id}

Request

  • Base URL: https://api.patricia.app (the document declares no server; this is the origin it was published from)
  • URL: https://api.patricia.app/v1/admin/tenants/{tenant_id}/team-skills/{skill_id}
  • Auth: HTTP bearer

Path parameters

tenant_idstring uuid required

The workspace id.

skill_idstring uuid required

The skill id, from the workspace's team skill list.

Request body

namestring nullable

The new name, 1 to 255 characters. The slug stays the same.

descriptionstring nullable

The new one-sentence description, 1 to 2,000 characters.

instructionsstring nullable

The complete new guidance, in plain markdown, 1 to 24,000 characters. It replaces the old instructions.

Response

Successful Response

skill_idstring uuid required
slugstring required
namestring required
kindstring required
source'workspace' | 'patricia' required
state'on' | 'paused' | 'stopped' required
changedboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.