Skip to main content
GET
/
skills
/
{id}
Get a skill
curl --request GET \
  --url https://app.gc.ai/api/external/v1/skills/{id} \
  --header 'Authorization: <api-key>'
{
  "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.

Response

The 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