Skip to main content
Perplexity

Search documentation

Type to search this documentation.

Get a skill download URL

GET/v1/skills/{skill_id}/downloadGet a skill download URL

Returns a short-lived URL to download the skill bundle as a zip. Without revision, returns the active revision.

Parameters

skill_idstringpathrequired

Skill identifier returned by create or `GET /v1/skills`

revisionstringquery

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

Responses

200The skill bundle downloadapplication/json
objectSkillDownload
download_urlstringrequired

Short-lived URL to download the zip bundle

namestring

Skill name at this revision

revisionstring

Opaque token of the downloaded revision

Example response
{
  "download_url": "string",
  "name": "string",
  "revision": "string"
}
400Invalid requestapplication/json
objectApiError
errorobject
Show child attributes
codeintegerrequired

HTTP status code

messagestringrequired

Human-readable error message

paramnull | string

Parameter that caused the error

typestringrequired

Error type identifier

Example response
{
  "error": {
    "code": 0,
    "message": "string",
    "param": "string",
    "type": "string"
  }
}
404Skill or revision not foundapplication/json
objectApiError
errorobject
Show child attributes
codeintegerrequired

HTTP status code

messagestringrequired

Human-readable error message

paramnull | string

Parameter that caused the error

typestringrequired

Error type identifier

Example response
{
  "error": {
    "code": 0,
    "message": "string",
    "param": "string",
    "type": "string"
  }
}
429Rate limit exceededapplication/json
objectApiError
errorobject
Show child attributes
codeintegerrequired

HTTP status code

messagestringrequired

Human-readable error message

paramnull | string

Parameter that caused the error

typestringrequired

Error type identifier

Example response
{
  "error": {
    "code": 0,
    "message": "string",
    "param": "string",
    "type": "string"
  }
}
502Skill service unavailableapplication/json
objectApiError
errorobject
Show child attributes
codeintegerrequired

HTTP status code

messagestringrequired

Human-readable error message

paramnull | string

Parameter that caused the error

typestringrequired

Error type identifier

Example response
{
  "error": {
    "code": 0,
    "message": "string",
    "param": "string",
    "type": "string"
  }
}
Documentation menu