Skip to main content
GET
/
api
/
public
/
v2
/
skill-collections
/
{identifier}
Get Skill Collection
curl --request GET \
  --url https://api.promptlayer.com/api/public/v2/skill-collections/{identifier} \
  --header 'X-API-KEY: <x-api-key>'
{
  "success": true,
  "skill_collection": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "workspace_id": 123,
    "folder_id": 123,
    "root_path": "<string>",
    "name": "<string>",
    "provider": "<string>",
    "is_deleted": true,
    "created_by": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_by": 123,
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "files": {},
  "version": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "skill_collection_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "workspace_id": 123,
    "number": 123,
    "root_path_at_version": "<string>",
    "provider": "<string>",
    "file_paths": [
      "<string>"
    ],
    "commit_message": "<string>",
    "release_label": "<string>",
    "archived": true,
    "created_by": 123,
    "user_email": "<string>",
    "created_at": "2023-11-07T05:31:56Z"
  }
}
Fetch a skill collection by UUID, collection name, or root path.

​
Response formats

Use format=zip to download the selected version as a ZIP archive. Omit the format parameter to receive the JSON payload shown in the schema. You can pin the response to a specific saved version with version, or to a labeled version with label.

Headers

​
X-API-KEY
string
required

Your PromptLayer API key.

Path Parameters

​
identifier
string
required

Skill collection UUID, name, or root_path.

Query Parameters

​
format
enum<string>

Omit this parameter for JSON, or use zip for an archive download.

Available options:
zip
​
label
string

Fetch a version pinned by release label. Mutually exclusive with version.

​
version
integer

Fetch a specific version number. Mutually exclusive with label.

Required range: x >= 1

Response

JSON payload or ZIP archive.

​
success
enum<boolean>
required
Available options:
true
​
skill_collection
object
required

A skill collection container in the public API.

​
files
object
required
​
version
object
required

A saved version of a skill collection.