Update skill

Update a skill. Requires an API key with ep:skills:write whose user administers skills in the account. A shared (account-scope) skill may be updated by any skill administrator; a private (user-scope) skill only by its author. Built-in skills and company copies of them cannot have their content edited, but a skill administrator may set enabled on one to enable or disable it for the whole company. The global built-in row is never changed; the response carries your company’s state.

PATCH /skills/{skill_id}

Update skill

Python

import requests

url = "https://api.datagrid.com/v1/skills/{skill_id}"

payload = {
    "name": "<string>",
    "slash_key": "<string>",
    "description": "<string>",
    "instructions": "<string>",
    "required_tools": ["<string>"],
    "preferred_tools": ["<string>"],
    "enabled": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

200

{
  "object": "skill",
  "id": "<string>",
  "scope": "user",
  "category": "document_analysis",
  "slash_key": "<string>",
  "name": "<string>",
  "description": "<string>",
  "instructions": "<string>",
  "required_tools": [
    "<string>"
  ],
  "preferred_tools": [
    "<string>"
  ],
  "enabled": true,
  "account_id": "<string>",
  "builtin_key": "<string>",
  "promoted_at": "2023-11-07T05:31:56Z",
  "creator_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

skill_id · string · required

The ID of the skill to update.

Body

application/json

name · string | null

Display name of the skill.

Maximum string length: 255

slash_key · string | null

The slash command key. Must use lowercase letters, digits, and single dashes, start and end with a letter or digit, and be unique within the scope.

Required string length: 1 - 64

Pattern: ^(?!.*--)[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$

description · string | null

Short description. Pass an empty string to clear it and re-enable AI generation.

Maximum string length: 1000

instructions · string | null

The full instructions / system prompt.

category · enum<string> | null

Category bucket.

Available options: document_analysis, construction_project_management, financial_analysis, estimation, quality_and_safety, scheduling, contracts_and_legal, data_and_reporting, research, communication, general_productivity

required_tools · string[] | null

Tool identifiers required by this skill.

preferred_tools · string[] | null

Tool identifiers preferred by this skill.

enabled · boolean | null

Whether the skill is active.

Response

200

application/json

Updated skill

object · enum<string> · required

The object type, always 'skill'.

Available options: skill

id · string · required

Unique identifier for the skill.

scope · enum<string> · required

Privacy scope. user = Private (author only), account = Public within the company, teamspace = deprecated legacy Public value retained only for compatibility, and builtin = global default. New skills never use teamspace; changing its privacy or assignments normalizes it.

Available options: user, account, teamspace, builtin

category · enum<string> · required

Category bucket for grouping in the skill picker.

Available options: document_analysis, construction_project_management, financial_analysis, estimation, quality_and_safety, scheduling, contracts_and_legal, data_and_reporting, research, communication, general_productivity

slash_key · string · required

The slash command key used to invoke this skill (e.g. budget-check).

name · string · required

Display name of the skill.

description · string · required

Short description shown in the skill picker.

instructions · string · required

The full instructions / system prompt for this skill.

required_tools · string[] · required

Tool identifiers that this skill requires to function.

preferred_tools · string[] · required

Tool identifiers that this skill works best with.

enabled · boolean · required

Whether the skill is active and available for selection. For a built-in skill, false when your company disabled it.

account_id · string | null · required

The account (company) that owns this skill. null for user-scope and builtin skills.

builtin_key · string | null · required

For built-in skills and company copies of them: the identifier of the built-in. null for user-authored skills.

promoted_at · string<date-time> | null · required

ISO timestamp when this skill was promoted to company scope. null for user-scope skills.

creator_id · string | null · required

ID of the user who created this skill. null for built-in skills that have never been edited.

created_at · string<date-time> · required

ISO timestamp when this skill was created.

updated_at · string<date-time> · required

ISO timestamp when this skill was last updated.