GCgc-ai
Skills

Update a skill

Partially update a skill's name, instructions, description, attached files, or legal category.

Requires write access to the skill. Official skills cannot be edited via the API. Visibility is not editable here; manage skill sharing in the GC AI app.

patch/skills/{id}

Request

Path parameters

idstring uuid required

Skill ID from GET /skills.

Request body

namestring

Updated skill name (1-255 chars)

contentstring

Updated skill instructions (1-100000 chars)

descriptionstring nullable

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

file_idsstring[]

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.

legal_category'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' nullable

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

Response

The updated skill

idstring uuid required

Unique skill identifier

namestring required

Skill name

descriptionstring nullable required

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

contentstring required

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

visibility'private' | 'organization' 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.

is_officialboolean required

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

legal_category'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' nullable required

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

created_atstring nullable required

ISO 8601 creation timestamp

updated_atstring nullable required

ISO 8601 last-updated timestamp

Changes

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