Sign in

v1

latestOpenAPI 3.0.12026-07-24283883639.5 KB
Skills+

Update a Skill

This endpoint updates a specific skill in Skills+. <h3>Required Scope</h3>skill:write

patch/api/v2/skills-plus-skills{id}

Path parameters

idstring required

The ID of the skill to update.

Request body

Example request

{
  "data": {
    "type": "skills-plus-skills",
    "id": "64kpY",
    "attributes": {
      "source-id": "o8Q",
      "description": "Updated description for Python",
      "external-id": "Python4",
      "is-proprietary": false,
      "is-endorsed": true,
      "is-archived": false,
      "skill-review-access": "Org",
      "skill-review-groups": "Engineering Group"
    }
  }
}

Response

Success

Example response

{
  "data": {
    "attributes": {
      "skill-name": "Python",
      "description": "Python description",
      "external-id": "123ab",
      "is-endorsed": true,
      "skill-review-visibility-groups": [],
      "skill-review-visibility-access-level": "Org",
      "synonyms": [],
      "skill-categories": [],
      "status": "Draft",
      "skill-source-name": "standard taxonomy",
      "skill-source-id": "o8Q"
    },
    "links": {
      "self": "https://api.betatest.degreed.com/api/v2/skills-plus-skills/1nZW2"
    }
  }
}