Create a term
POST
/v1/skill-taxonomies/{taxonomyId}/termscurl -X POST 'https://api.embodiflow.io/v1/skill-taxonomies/{taxonomyId}/terms' \
-H 'Authorization: Bearer $EMBODIFLOW_PAT' \
-H 'Content-Type: application/json' \
-d '{
"termIdentity": "string",
"code": "string",
"displayLabel": "string",
"labels": {},
"parentTermIdentity": "string",
"assignable": true,
"definition": "string",
"positiveExamples": [
"string"
],
"negativeExamples": [
"string"
],
"enabled": true,
"status": "active",
"successorTermIdentity": "string"
}'认证
每个请求都需要携带个人访问令牌（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.
请求体
Content-Typeapplication/json
- termIdentitystring
- codestring
- displayLabelstring
- labelsobject
- parentTermIdentitystring | null
- assignableboolean
- definitionstring
- positiveExamplesarray<string>
- negativeExamplesarray<string>
- enabledboolean
- statusstring可选值activedeprecatedretired
- successorTermIdentitystring | null
响应
Success
- dataobject必填
- idstring | null必填
- termIdentitystring必填
- codestring必填
- displayLabelstring必填
- labelsobject必填
- parentTermIdentitystring | null必填
- assignableone of必填
- definitionstring必填
- positiveExamplesarray<string>必填
- negativeExamplesarray<string>必填
- externalMappingsarray<SkillExternalMapping>必填
- originLayerstring必填可选值tenantprojectplatform
- statusstring必填可选值activedeprecatedretired
- successorTermIdentitystring | null必填
- enabledone of必填
- coverageFloorone of必填
- provenanceobject必填
- sourcesobject必填
响应示例
{
"data": {
"id": "string",
"termIdentity": "string",
"code": "string",
"displayLabel": "string",
"labels": {},
"parentTermIdentity": "string",
"assignable": false,
"definition": "string",
"positiveExamples": [
"string"
],
"negativeExamples": [
"string"
],
"externalMappings": [
{
"source": "string",
"sourceVersion": "string",
"externalCode": "string",
"externalLabel": "string",
"mappingKind": "exact",
"confidence": 0
}
],
"originLayer": "tenant",
"status": "active",
"successorTermIdentity": "string",
"enabled": false,
"coverageFloor": false,
"provenance": {
"originLayer": "tenant",
"sourceRevision": "string",
"fields": {}
},
"sources": {}
}
}服务器https://api.embodiflow.io/v1https://api.embodiflow.dev/v1