Archive skills

Bulk-archive (soft-delete) API-origin skills 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 archived 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. Bob-created skills cannot be archived via this API and are reported as not found.
  • Retry only after correcting the failed items. Successful items in the same request are already archived.
Body Params
items
array of objects
required
length between 1 and 100

Skills to archive (1–100 items).

items*

A skill to archive, resolved by its /skill/source + /skill/externalId locator.

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.

Responses

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