Update a skill taxonomy
PATCH
/v1/skill-taxonomies/{taxonomyId}curl -X PATCH 'https://api.embodiflow.io/v1/skill-taxonomies/{taxonomyId}' \
-H 'Authorization: Bearer $EMBODIFLOW_PAT' \
-H 'Content-Type: application/json' \
-d '{
"name": "string",
"status": "draft"
}'认证
每个请求都需要携带个人访问令牌(PAT)。
- Authorization: Bearer PAT
路径参数
- taxonomyIdstring必填
请求头参数
- idempotency-keystring必填
- 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.
请求体
Content-Typeapplication/json
- namestring
- statusstring可选值draftpublishedarchived
响应
Success
- dataobject必填
- idstring必填
- tenantIdstring必填
- projectIdstring | null必填
- scopeLevelstring必填可选值tenantproject
- namestring必填
- contractVersionstring必填
- revisionnumber必填
- statusstring必填可选值draftpublishedarchived
- sourceSnapshotHashstring必填
- publishedAtstring | null必填
- createdAtstring必填
- updatedAtstring必填
- rowVersionnumber必填
响应示例
{
"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
}
}服务器https://api.embodiflow.io/v1https://api.embodiflow.dev/v1