Create a derived version
POST
/v1/datasets/{datasetId}/versions/{versionId}/derived-versionscurl -X POST 'https://api.embodiflow.io/v1/datasets/{datasetId}/versions/{versionId}/derived-versions' \
-H 'Authorization: Bearer $EMBODIFLOW_PAT' \
-H 'Content-Type: application/json' \
-d '{
"steps": [
{
"code": "convert-to-mcap",
"name": "string",
"enabled": false,
"summary": "string",
"params": {},
"internalOnly": false,
"outputSourceType": "string"
}
],
"outputSourceType": "string",
"versionName": "string",
"description": "string"
}'Authorization
Send a personal access token with every request.
- Authorization: Bearer PAT
Path parameters
- datasetIdstringrequired
- versionIdstringrequired
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
- stepsarray<RosCleaningStepDto>required
- codestringrequiredAllowed valuesconvert-to-mcapresample-topicinterpolate-topicfilter-topicrename-topictrim-time-rangealign-topics
- namestringrequired
- enabledone ofrequired
- summarystringrequired
- paramsobject | null
- internalOnlyone of
- outputSourceTypestring | null
- outputSourceTypestring
- versionNamestring | null
- descriptionstring | null
Responses
Success
- dataobjectrequired
- datasetIdstringrequired
- sourceDatasetVersionIdstringrequired
- derivedDatasetVersionIdstringrequired
- outputSourceTypestringrequired
- artifactIdstring | nullrequired
- recipeobject | nullrequired
Response example
{
"data": {
"datasetId": "string",
"sourceDatasetVersionId": "string",
"derivedDatasetVersionId": "string",
"outputSourceType": "string",
"artifactId": "string",
"recipe": {}
}
}Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1