Skip to main content
Perplexity

Search documentation

Type to search this documentation.

Create a skill

POST

/

v1

/

skills

Create a skill

curl --request POST \
  --url https://api.perplexity.ai/v1/skills \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'
title="201"
{
  "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"
}
title="400"
{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "param": "<string>"
  }
}
title="409"
{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "param": "<string>"
  }
}
title="413"
{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "param": "<string>"
  }
}
title="429"
{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "param": "<string>"
  }
}
title="502"
{
  "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.

multipart/form-data

The skill bundle as a zip archive

file

file

required

The skill bundle, a zip archive containing SKILL.md

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

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu