Update skills

Bulk-update API-origin skills resolved by source + externalId locator.

Bulk-update API-origin skills. Always a bulk operation: send an items array
(1–100 items). Each item is resolved by its /skill/source +
/skill/externalId locator and must include at least one writable field.
Updates apply only to skills created via this public API; a locator that points
to a non-API-origin skill is reported as not found.

/skill/proficiencyLevels is a full replacement when supplied. Per-item results
are returned in results; the request returns 200 even when some items fail.

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 update (1–100 items).

items*

A skill to update, resolved by its /skill/source + /skill/externalId locator.
Only fields present in the item are changed.

string
required

External source system that owns this skill. Required — part of the locator.

string
required

External ID of the skill in the source system. Required — part of the locator.

string | null

New skill display name.

string | null

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

string | null

New category display name. Must reference an existing category.

enum

New lifecycle status.


Lifecycle status of a skill.

/skill/proficiencyLevels
array of objects | null

Full replacement of the skill's proficiency-level content. Omit to leave
existing content unchanged; send an empty array to remove all content.

/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