Create Skill | PrivateGPT

Create a new skill in a collection from multipart form fields and uploaded files.

anthropic-betalist of strings or nullOptional

Multipart form payload used to create a skill and its initial files.

display_titlestringRequired1-255 characters

display title field.

collectionstringRequired1-255 characters

collection field.

sourceenumOptionalDefaults to custom

source field.

loadingenumOptionalDefaults to lazy

loading field.

readonlybooleanOptionalDefaults to false

readonly field.

Skill created successfully.

idstring

Unique skill identifier.

created_atdatetime

Creation timestamp.

display_titlestring

Human display title.

sourceenum

Source of the skill.

updated_atdatetime

Update timestamp.

collectionstring

Tenant identifier (org_id boundary).

loadingenum

Instruction loading strategy.

readonlyboolean

Readonly flag.

latest_versionstring or null

Latest version token for this skill.

type"skill"Defaults to skill

Object type.

401

Unauthorized Error

422

Unprocessable Entity Error

$	curl -X POST /v1/skills \
>	-H "Content-Type: application/x-www-form-urlencoded" \
>	-d "display_title=Sales%20Ops%20Helper" \
>	-d "collection=acme-prod" \
>	-d "source=custom" \
>	-d "loading=lazy" \
>	-d "readonly=false"

1	{
2	"id": "skill_01HZX8N83J4WQ2E4K4G3Q2H9E8",
3	"created_at": "2026-04-16T10:30:00Z",
4	"display_title": "Sales Ops Helper",
5	"source": "custom",
6	"updated_at": "2026-04-16T10:30:00Z",
7	"collection": "acme-prod",
8	"loading": "lazy",
9	"readonly": false,
10	"latest_version": "v1",
11	"type": "skill"
12	}