v1

latestOpenAPI 3.1.02026-08-04164270844.7 KB

Skills

Upsert skills

🔑

Required OAuth scope: skills:bulk.

🚜

This endpoint processes up to 10,000 objects asynchronously. For more information, see the Bulk operations guide.

Adds or replaces multiple skills based on the given externalId.

If a provided externalId matches an existing skill, the skill is replaced with the new data.
If no match is found, a new skill is created.

Upon submission, the request is queued. Use the provided URL in the response header to check the status of the bulk operation.

put/api/v2/bulk/skills

Headers

360-api-version'v2.0' required

The version of the API.

Request body

Example request

{
  "input": [
    {
      "externalId": "5d9b7bf9-47bf-40ca-b670-2a2a80d992da",
      "name": "Releases and deployments",
      "description": "Did the user already release the software on the production environment?",
      "libraryId": "6b14f596-b5dd-40bf-af4c-a4270487a3c4",
      "parentExternalIds": [
        "477e108e-60b5-4908-856e-aa123e133921"
      ],
      "translations": [
        {
          "lang": "fr",
          "translatedFields": {
            "name": "Le nom traduit en français",
            "description": "Traduction en français de la description."
          }
        }
      ]
    }
  ]
}

Response

The operation is successfully created.