Publishes the confirmed draft as the next immutable revision. The path is the REST noun (`revisions`): the public contract refuses verb segments.
POST
/v1/rig-profiles/{id}/revisionscurl -X POST 'https://api.embodiflow.io/v1/rig-profiles/{id}/revisions' \
-H 'Authorization: Bearer $EMBODIFLOW_PAT'Authorization
Send a personal access token with every request.
- Authorization: Bearer PAT
Path parameters
- idstringrequired
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.
Responses
Success
- dataobjectrequired
- idstringrequired
- namestringrequired
- statusstringrequiredAllowed valuesdraftpublished
- sourceRecordingIdstring | nullrequired
- latestRevisionnumber | nullrequired
- publishedAtstring | nullrequired
- createdAtstringrequired
- updatedAtstringrequired
- draftobjectrequired
- needsConfirmationarray<string>required
- factsobject | nullrequired
- revisionsarray<object>required
Response example
{
"data": {
"id": "string",
"name": "string",
"status": "draft",
"sourceRecordingId": "string",
"latestRevision": 0,
"publishedAt": "string",
"createdAt": "string",
"updatedAt": "string",
"draft": {
"profile": "string",
"sourceKind": "human",
"robotType": "string",
"match": {
"topics": [
"string"
],
"emptyTopics": [
"string"
],
"sidecar": "string",
"deviceType": "string"
},
"cameras": [
{
"topic": "string",
"key": "string",
"role": "other",
"sensor": "string",
"optional": false,
"latencyMs": 0,
"needsConfirmation": false
}
],
"stampSource": "header_stamp",
"cameraLatencyMs": 0,
"calibration": {
"distortion": "none",
"stereo": {
"left": "string",
"right": "string",
"extrinsicOn": "string",
"meaning": "string"
},
"camImu": {
"on": "string",
"key": "string",
"meaning": "string",
"translationUnit": "m"
}
},
"imu": {
"topic": "string",
"frame": "string",
"features": {
"angular_velocity": "string",
"linear_acceleration": "string"
},
"orientation": "ignore"
},
"state": [
{
"topic": "string",
"names": [
"string"
],
"unit": "m",
"unnamed": false,
"range": {
"min": 0,
"max": 0
},
"semantics": "string",
"needsConfirmation": false
}
],
"action": "none",
"actionSemantics": {
"space": "robot_joint",
"representation": "absolute",
"frame": "string",
"calibrationId": "string",
"embodimentId": "string",
"controlRateHz": 0
},
"extraState": [
{
"topic": "string",
"key": "string",
"shape": [
0
],
"names": [
"string"
],
"frame": "string",
"unit": "m"
}
],
"extraAction": [
{
"topic": "string",
"key": "string",
"shape": [
0
],
"names": [
"string"
],
"frame": "string",
"unit": "m"
}
],
"dropped": [
{
"topic": "string",
"reason": "string"
}
],
"sidecarsKept": [
"string"
]
},
"needsConfirmation": [
"string"
],
"facts": {
"topics": [
{
"topic": "string",
"schema": "string",
"messageCount": 0
}
],
"stampSkewMs": [
{
"topic": "string",
"medianMs": 0
}
],
"bytesRead": 0
},
"revisions": [
{
"id": "string",
"revision": 0,
"publishedAt": "string",
"publishedBy": "string",
"documentHash": "string"
}
]
}
}Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1