Skip to main content
POST
Create 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.

Body

application/json
name
string
required

Skill name (required, 1-255 chars)

Required string length: 1 - 255
Example:

"NDA Risk Reviewer"

content
string
required

The skill instructions — the prompt text the model receives when the skill runs (required, 1-100000 chars)

Required string length: 1 - 100000
Example:

"Review the attached NDA and flag any clauses that deviate from our standard positions."

description
string | null

Optional short description of what the skill does (max 1000 chars)

Maximum string length: 1000
visibility
enum<string>

Skill visibility. Defaults to private for user-scoped keys. Org-scoped keys always create organization-visible skills (they have no owning user).

Available options:
private,
organization
file_ids
string<uuid>[]

Optional uploaded file IDs to attach as reference context (max 50). Upload files first via POST /files.

Maximum array length: 50

Response

The created 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