Skip to main content
PATCH
Update a skill

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

Updated area of law to group the skill under. Pass null to clear it. Omit to leave it unchanged.

Available options:
commercial_contracts,
privacy_compliance,
employment,
procurement,
governance,
product_and_ip_counsel,
legal_operations,
real_estate_and_insurance,
litigation_and_disputes,
regulatory_and_compliance,
other,
null

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

The area of law the skill is grouped under, or null when it is uncategorized

Available options:
commercial_contracts,
privacy_compliance,
employment,
procurement,
governance,
product_and_ip_counsel,
legal_operations,
real_estate_and_insurance,
litigation_and_disputes,
regulatory_and_compliance,
other,
null
created_at
string | null
required

ISO 8601 creation timestamp

updated_at
string | null
required

ISO 8601 last-updated timestamp

Last modified on June 16, 2026