Update skills

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

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 updated 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.
  • Items are resolved only by /skill/source + /skill/externalId. Locators that point to Bob-created (non-API-origin) skills are reported as not found.
  • Common per-item failures include missing locator fields, no writable field provided, skill not found, and unknown proficiency level IDs.
  • Retry only after correcting the failed items. Successful items in the same request are already updated.
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