Update skill

curl --request PATCH \ --url https://api.agile-tools.io/v1/public/skills/{id} \ --header 'Content-Type: application/merge-patch+json' \ --header 'X-API-Key: <api-key>' \ --data ' { "name": "Python 3", "active": false } '

{ "data": { "id": "4f5c6d7e-0000-0000-0000-000000000001", "name": "Python (programming language)", "description": "General-purpose programming language", "scopeNote": "Includes scripting, automation and data processing use cases.", "reuseLevel": "transversal", "collections": [ "digital" ], "category": "Programming", "skillType": "skill/competence", "proficiencyScale": "1-10", "externalId": "SKILL_PYTHON", "active": true, "global": false }, "meta": { "requestId": "f056699e-497d-41d9-a877-d7c862de6587", "timestamp": "2026-04-03T12:08:00Z" } }

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

string

required

Body

application/merge-patch+json

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

name

string | null

Display name of the skill. Omit to keep unchanged.

Example:

"Python 3"

description

string | null

Description of the skill. Provide null to clear it.

Example:

"General-purpose programming language (modern)"

Response

Skill updated

string

name

string

description

string

scopeNote

string

reuseLevel

string

collections

string[]

API

API Reference

API Guides

CLI

Integration Automation

Support

Authorizations

Path Parameters

Body

Response