Add a skill revision

PUT

/

v1

/

skills

/

Add a skill revision

curl --request PUT \
  --url https://api.perplexity.ai/v1/skills/{skill_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'

{
  "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>"
  }
}

{
  "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

expected_revision

string

required

Opaque revision token the skill must currently be at. The write applies only if it matches, so it cannot race a concurrent update.

multipart/form-data

The skill bundle as a zip archive

file

file

required

The skill bundle, a zip archive containing SKILL.md

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