Create skills

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

Testing notes:

  1. Use the testing widget's Try It! option to test this endpoint.
  2. Use the Examples > Request Example option to see how to initiate body parameters. Copy the example into an external tool if needed.

Error handling:

This endpoint always returns HTTP 200 when the request is accepted, even if some items in the items array fail.

  • Inspect the results array for every item — do not assume all skills were created because the top-level call returned 200.
  • Each result includes index (matching the request item), status (succeeded or failed), httpStatus, and either a resource or an errors array.
  • Common per-item failures include missing required fields, duplicate /skill/source + /skill/externalId, duplicate /skill/name, and unknown proficiency level IDs.
  • Retry only after correcting the failed items. Successful items in the same request are already created.
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