Get a skill

GET

/

v1

/

skills

/

Get a skill

curl --request GET \
  --url https://api.perplexity.ai/v1/skills/{skill_id} \
  --header 'Authorization: Bearer <token>'

{
  "skill_id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "revision": "<string>",
  "latest_revision": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "param": "<string>"
  }
}

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

skill_id

string

required

Skill identifier returned by create or GET /v1/skills

revision

string

Opaque revision token; when omitted, the active revision is used

The skill

skill_id

string

required

Skill identifier

name

string

Skill name, read from the bundle's SKILL.md

description

string

Skill description, read from the bundle's SKILL.md

revision

string

Opaque token of the revision returned in this response; the latest revision, or the specific one requested via revision

latest_revision

string

Opaque token of the skill's current latest revision; pass as expected_revision to update or delete

created_at

string<date-time>

updated_at

string<date-time>

Was this page helpful?

⌘I