Create skills

Bulk-create API-origin skills with per-item results.

Bulk-create API-origin skills. Always a bulk operation: send an items array
(1–100 items). Each item is validated independently and reported per-item in
results; the request returns 200 even when some items fail.

Required fields per item: /skill/name, /skill/source, /skill/externalId.
The /skill/source + /skill/externalId pair must be unique per company, and
/skill/name must be unique per company (both within the request and against
existing skills). Unknown proficiency level IDs, duplicate locators, duplicate
skill names, and invalid status values are reported as per-item failures.

Rate limit: 10 requests/min per tenant.

OAuth scope (app-user): job_catalog.skills:write.

IAM permission: Job catalog / Skills / Manage (company-scoped).

Body Params
items
array of objects
required
length between 1 and 100
Defaults to [object Object]

Skills to create (1–100 items).

items*

A skill to create, expressed as a flat fieldId: value object.

string
required

Skill display name. Required.

string
required

External source system that owns this skill. Required; combined with
/skill/externalId it must be unique per company.

string
required

External ID of the skill in the source system. Required; combined with
/skill/source it must be unique per company.

string | null

Optional free-text description (up to 1000 characters).

string | null

Optional category display name. If the category does not exist it is created.

enum

Optional lifecycle status. Defaults to active when omitted.


Lifecycle status of a skill.

/skill/proficiencyLevels
array of objects | null

Optional per-skill proficiency-level content. When supplied it becomes the
full proficiency-level set for the skill.

/skill/proficiencyLevels
Responses

Language
Credentials
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json