Skip to main content
PATCH
Update job position

Authorizations

X-API-Key
string
header
required

Owner-typed API key (ORGANIZATION, PERSON, VALUE_UNIT). Manage org-scoped lifecycle with /v1/public-api-keys; cross-org governance is restricted to /v1/sys/public-api-keys.

Path Parameters

id
string
required

Body

application/merge-patch+json

Merge-patch payload for job-position updates. Omitted fields remain unchanged. Explicit null clears the nullable fields. Global ESCO rows are read-only.

name
string | null

Display name of the job position. Omit to keep unchanged.

Example:

"Staff Software Engineer"

description
string | null

Description of the job position. Provide null to clear it.

Example:

"Owns cross-team delivery"

code
string | null

Organization-specific code. Provide null to clear it.

Example:

"STAFF-SWE"

iscoGroup
string | null

ISCO-08 group code. Provide null to clear it.

Example:

"2512"

active
boolean | null

Whether the position is active for assignments. Omit to keep unchanged.

Example:

false

externalId
string | null

External system identifier. Provide null to clear it.

Example:

"JOB_POSITION_STAFF_SWE"

skills
object[] | null

Required skills of the org-custom position. Provide null or an empty list to clear the required-skills profile. Each entry carries the skill id, requiredness (ESSENTIAL/OPTIONAL) and an optional explicit target (1-10; null derives from the relation type).

Example:

Response

Job position updated

id
string
name
string
description
string
code
string
iscoGroup
string
externalId
string
active
boolean
global
boolean
requiredSkills
object[]