Skip to main content
POST
/
api
/
public
/
v2
/
skill-collections
Create Skill Collection
curl --request POST \
  --url https://api.promptlayer.com/api/public/v2/skill-collections \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "name": "<string>",
  "folder_id": 123,
  "provider": "<string>",
  "files": [],
  "commit_message": "<string>",
  "external_ids": [
    {
      "source": "<string>",
      "external_id": "<string>"
    }
  ]
}
'
{
  "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",
    "external_ids": [
      {
        "source": "<string>",
        "external_id": "<string>"
      }
    ]
  },
  "external_ids": [
    {
      "source": "<string>",
      "external_id": "<string>"
    }
  ]
}
Create a new skill collection using either a JSON body or a multipart form upload with a ZIP archive.

​
Request formats

Use application/json when sending file contents inline through the files array. Use multipart/form-data when uploading a ZIP archive. Pass metadata as a JSON string in metadata or json, and include the file in archive or zip.

Authorizations

​
X-API-KEY
string
header
required

Body

​
name
string
required
​
folder_id
integer | null
​
provider
string | null
​
files
object[]
​
commit_message
string | null
​
external_ids
ExternalId · object[]

Identifiers from other systems.

Response

Skill collection created successfully.

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

A skill collection container in the public API.

​
external_ids
ExternalId · object[]
required

External ID mappings for the skill collection.