Create a data format

POST

/v1/data-formats

curl -X POST 'https://api.embodiflow.io/v1/data-formats' \
  -H 'Authorization: Bearer $EMBODIFLOW_PAT' \
  -H 'Content-Type: application/json' \
  -d '{
    "dataKind": "robot",
    "slug": "string",
    "card": {},
    "converter": {}
  }'

认证

每个请求都需要携带个人访问令牌（PAT）。

Authorization: Bearer PAT

认证指南

请求头参数

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

dataKindstring必填
可选值
robot
human
slugstring必填
`x-<name>`: unique per team and never changed afterwards.
cardobject
converterobject

响应

Success

dataobject必填
- idstring必填
- dataKindstring必填
  可选值
  human
  robot
- slugstring必填
- statusstring必填
  可选值
  draft
  published
  archived
- currentRevisionnumber | null必填
- createdAtstring必填
- updatedAtstring必填
- draftobject必填
- latestSampleRunIdstring | null必填
- revisionsarray<TeamDataFormatRevisionDto>必填

响应示例

{
  "data": {
    "id": "string",
    "dataKind": "human",
    "slug": "string",
    "status": "draft",
    "currentRevision": 0,
    "createdAt": "string",
    "updatedAt": "string",
    "draft": {
      "card": {
        "title": "string",
        "description": "string",
        "illustration": "human",
        "fileRules": {
          "unit": "folder",
          "extensions": [
            "string"
          ],
          "requiredFiles": [
            "string"
          ]
        },
        "requiresTaskSidecar": false,
        "privacyRequirement": "required"
      },
      "converter": {
        "kind": "rig_profile",
        "rigProfileRevisionId": "string"
      }
    },
    "latestSampleRunId": "string",
    "revisions": [
      {
        "id": "string",
        "revision": 0,
        "card": {
          "title": "string",
          "description": "string",
          "illustration": "human",
          "fileRules": {
            "unit": "folder",
            "extensions": [],
            "requiredFiles": []
          },
          "requiresTaskSidecar": false,
          "privacyRequirement": "required"
        },
        "converter": {
          "kind": "rig_profile",
          "rigProfileRevisionId": "string"
        },
        "sampleRunId": "string",
        "publishedAt": "string",
        "publishedBy": "string"
      }
    ]
  }
}

服务器https://api.embodiflow.io/v1https://api.embodiflow.dev/v1

curl -X POST 'https://api.embodiflow.io/v1/data-formats' \ -H 'Authorization: Bearer $EMBODIFLOW_PAT' \ -H 'Content-Type: application/json' \ -d '{ "dataKind": "robot", "slug": "string", "card": {}, "converter": {} }'

{ "data": { "id": "string", "dataKind": "human", "slug": "string", "status": "draft", "currentRevision": 0, "createdAt": "string", "updatedAt": "string", "draft": { "card": { "title": "string", "description": "string", "illustration": "human", "fileRules": { "unit": "folder", "extensions": [ "string" ], "requiredFiles": [ "string" ] }, "requiresTaskSidecar": false, "privacyRequirement": "required" }, "converter": { "kind": "rig_profile", "rigProfileRevisionId": "string" } }, "latestSampleRunId": "string", "revisions": [ { "id": "string", "revision": 0, "card": { "title": "string", "description": "string", "illustration": "human", "fileRules": { "unit": "folder", "extensions": [], "requiredFiles": [] }, "requiresTaskSidecar": false, "privacyRequirement": "required" }, "converter": { "kind": "rig_profile", "rigProfileRevisionId": "string" }, "sampleRunId": "string", "publishedAt": "string", "publishedBy": "string" } ] } }