Create a task
POST
/v1/projects/{projectId}/collection-orders/{orderId}/taskscurl -X POST 'https://api.embodiflow.io/v1/projects/{projectId}/collection-orders/{orderId}/tasks' \
-H 'Authorization: Bearer $EMBODIFLOW_PAT' \
-H 'Content-Type: application/json' \
-d '{
"name": "string",
"instructionJson": {
"en": "string",
"zh": "string"
},
"startCondition": "string",
"endCondition": "string",
"allowedVariation": "string",
"durationMinS": 0,
"durationMaxS": 0,
"requiredCameras": "head",
"requiredModalities": "imu",
"minHandsVisible": 0,
"recordingMode": "continuous",
"orderIndex": 0
}'Authorization
Send a personal access token with every request.
- Authorization: Bearer PAT
Path parameters
- projectIdstringrequired
- orderIdstringrequired
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
- namestringrequired
- instructionJsonobject
- enstring
- zhstring
- startConditionstringrequired
- endConditionstringrequired
- allowedVariationstring | null
- durationMinSnumber | null
- durationMaxSnumber | null
- requiredCamerasarray<string>
- requiredModalitiesarray<string>
- minHandsVisiblenumber | null
- recordingModestringAllowed valuescontinuoussingle_task
- orderIndexnumberrequired
Responses
Success
- dataobjectrequired
- idstringrequired
- orderIdstringrequired
- namestringrequired
- instructionJsonobjectrequired
- demoMediaKeysarray<string>required
- startConditionstringrequired
- endConditionstringrequired
- allowedVariationstring | nullrequired
- durationMinSnumber | nullrequired
- durationMaxSnumber | nullrequired
- requiredCamerasarray<string>required
- requiredModalitiesarray<string>required
- minHandsVisiblenumber | nullrequired
- recordingModestringrequiredAllowed valuescontinuoussingle_task
- orderIndexnumberrequired
- createdAtstringrequired
- updatedAtstringrequired
- rowVersionnumberrequired
Response example
{
"data": {
"id": "string",
"orderId": "string",
"name": "string",
"instructionJson": {
"en": "string",
"zh": "string"
},
"demoMediaKeys": [
"string"
],
"startCondition": "string",
"endCondition": "string",
"allowedVariation": "string",
"durationMinS": 0,
"durationMaxS": 0,
"requiredCameras": "other",
"requiredModalities": "imu",
"minHandsVisible": 0,
"recordingMode": "continuous",
"orderIndex": 0,
"createdAt": "string",
"updatedAt": "string",
"rowVersion": 0
}
}Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1