Update a skill taxonomy

Authorization

Send a personal access token with every request.

• Authorization: Bearer PAT

Path parameters

• taxonomyIdstringrequired

Header parameters

• idempotency-keystringrequired
• Idempotency-Keystring

  Optional idempotency key, at most 255 characters (UUIDv4 recommended). A repeated key returns the first response byte-for-byte, including a 5xx. The same key with a different body, or a second in-flight request, returns 409 IDEMPOTENCY_CONFLICT. Keys are unique per tenant and retained for 24 hours.

• If-Matchstring

  Optional precondition. A matching tag proceeds and returns the new ETag. A stale tag returns 412 PRECONDITION_FAILED with no write. Absent proceeds (opt-in this release). If-Match: * succeeds when the resource exists. Malformed values return 400 IF_MATCH_INVALID.

Request body

• namestring
• statusstring
  Allowed values

  draft

  published

  archived

Responses

{
  "data": {
    "id": "string",
    "tenantId": "string",
    "projectId": "string",
    "scopeLevel": "tenant",
    "name": "string",
    "contractVersion": "string",
    "revision": 0,
    "status": "draft",
    "sourceSnapshotHash": "string",
    "publishedAt": "string",
    "createdAt": "string",
    "updatedAt": "string",
    "rowVersion": 0
  }
}