Skip to main content
PATCH
/
skills
/
{id}
Update a skill
curl --request PATCH \
  --url https://app.gc.ai/api/external/v1/skills/{id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "content": "<string>",
  "description": "<string>",
  "file_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "description": "<string>",
  "content": "<string>",
  "is_official": true,
  "files": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    }
  ],
  "created_at": "<string>",
  "updated_at": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Format: gcai_xxxxxxxxx

Create API keys in the GC AI app under Settings → API.

Path Parameters

​
id
string<uuid>
required

Skill ID from GET /skills.

Body

application/json
​
name
string

Updated skill name (1-255 chars)

Required string length: 1 - 255
​
content
string

Updated skill instructions (1-100000 chars)

Required string length: 1 - 100000
​
description
string | null

Updated description (max 1000 chars). Pass null or an empty string to clear it.

Maximum string length: 1000
​
file_ids
string<uuid>[]

Replacement set of attached file IDs (max 50). When provided, the skill's attachments are reconciled to exactly this list. Omit to leave attachments unchanged.

Maximum array length: 50

Response

The updated skill

​
id
string<uuid>
required

Unique skill identifier

​
name
string
required

Skill name

​
description
string | null
required

Short description of what the skill does, or null if unset

​
content
string
required

The skill instructions — the prompt text the model receives when the skill runs

​
visibility
enum<string>
required

private (only the creator and users it has been explicitly shared with) or organization (visible to everyone in the org). Official skills report organization.

Available options:
private,
organization
​
is_official
boolean
required

Whether this is an official GC AI skill. Official skills are read-only and cannot be edited or deleted via the API.

​
files
object[]
required

Files attached to the skill as reference context

​
created_at
string | null
required

ISO 8601 creation timestamp

​
updated_at
string | null
required

ISO 8601 last-updated timestamp