Publishes the draft as the next immutable revision. The path is the REST noun (`revisions`): the public contract refuses verb segments.
POST
/v1/data-formats/{formatId}/revisionscurl -X POST 'https://api.embodiflow.io/v1/data-formats/{formatId}/revisions' \
-H 'Authorization: Bearer $EMBODIFLOW_PAT' \
-H 'Content-Type: application/json' \
-d '{
"sampleRunId": "00000000-0000-0000-0000-000000000000"
}'Authorization
Send a personal access token with every request.
- Authorization: Bearer PAT
Path parameters
- formatIdstringrequired
Header parameters
- 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.
Request body
Content-Typeapplication/json
- sampleRunIdstring (uuid)required
A `passed` sample run of this format's current converter.
Responses
Success
- dataobjectrequired
- idstringrequired
- dataKindstringrequiredAllowed valueshumanrobot
- slugstringrequired
- statusstringrequiredAllowed valuesdraftpublishedarchived
- currentRevisionnumber | nullrequired
- createdAtstringrequired
- updatedAtstringrequired
- draftobjectrequired
- latestSampleRunIdstring | nullrequired
- revisionsarray<TeamDataFormatRevisionDto>required
Response example
{
"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"
}
]
}
}Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1