Skip to main content
PATCH
Update Skill

Overview

The Update Skill endpoint lets you modify an existing skill’s details. Only include the fields you want to change. Pass null for optional fields to clear them.
Scope required: skills:write | Rate limit: 20 requests/min

Request

Path Parameters

string
required
The skill’s unique ID

Body Parameters

All fields are optional, but at least one must be provided.
string
Skill name (max 200 characters)
string
Skill category. One of: TECHNICAL, SOFT, or LANGUAGE
string
Free-text level label, e.g. “Expert”, “Intermediate”. (max 50 characters) (nullable)
number
Numeric proficiency 1-5. (nullable)
boolean
Visibility flag on the skill itself - false hides the skill outright. To hide it on just one resume, use hiddenItems on that resume instead.
number
Sort order of the skill

Query Parameters

string
Target a specific resume by its id (from list-resumes). Omit to use your base/default resume; the resume must be self-contained.

Example

Response

boolean
Whether the skill was updated
string
The skill’s ID