Skills

Update a skill

Renaming a skill also rewrites the skill's name in every AI action that references it.

patch/api/v1/skills/{skill_name}

Request

  • Base URL: https://your-tenant.tines.com
  • URL: https://your-tenant.tines.com/api/v1/skills/{skill_name}
  • Auth: one of:
    • API key in header X-User-Token
    • HTTP bearer

Path parameters

skill_namestring required

The skill name

Request body

team_idinteger required

The team that owns the skill

namestring

Renames the skill

descriptionstring

What the skill does and when to use it. AI agents are shown only the name and description, and match a task against them to decide whether to load the skill

bodystring

The full skill instructions, in markdown. Loaded only after the description matches the task at hand

licensestring

License the skill is distributed under

compatibilitystring

Free-text note on what the skill is compatible with

metadataobject

Flat map of string keys to string values. Sets the whole map, so send every key you want to keep

Response

Successful response

namestring

Skill name

descriptionstring

What the skill does and when to use it. AI agents are shown only the name and description, and match a task against them to decide whether to load the skill

bodystring

The full skill instructions, in markdown. Loaded only after the description matches the task at hand

licensestring nullable

License the skill is distributed under

compatibilitystring nullable

Free-text note on what the skill is compatible with

metadataobject

Flat map of string keys to string values, empty when none are set

team_idinteger

ID of the team that owns the skill

created_atstring

When the skill was created

updated_atstring

When the skill was last updated

Changes

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