Create a promotion

POST

/v1/model-versions/{modelVersionId}/promotions

curl -X POST 'https://api.embodiflow.io/v1/model-versions/{modelVersionId}/promotions' \
  -H 'Authorization: Bearer $EMBODIFLOW_PAT'

Authorization

Send a personal access token with every request.

Authorization: Bearer PAT

Authentication guide

Path parameters

modelVersionIdstringrequired

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
- tenantIdstringrequired
- projectIdstringrequired
- modelImageDefinitionIdstring | nullrequired
- namestringrequired
- sourceTypestringrequired
  Allowed values
  trained
  imported
- sourceTrainingJobIdstring | nullrequired
- artifactIdstring | nullrequired
- statusstringrequired
  Allowed values
  draft
  archived
  registered
- paramsSnapshotobject | nullrequired
- evalMetricsobject | nullrequired
- compatibleEmbodimentCodesarray<string>required
- policyFamilystring | nullrequired
- wireProtocolsarray<string>required
- bundleStatusstringrequired
- bundleFailureCodestring | nullrequired
- registeredAtstring | nullrequired
- createdAtstringrequired
- updatedAtstringrequired
- trainedOnobject

Response example

{
  "data": {
    "id": "string",
    "tenantId": "string",
    "projectId": "string",
    "modelImageDefinitionId": "string",
    "name": "string",
    "sourceType": "trained",
    "sourceTrainingJobId": "string",
    "artifactId": "string",
    "status": "draft",
    "paramsSnapshot": {},
    "evalMetrics": {},
    "compatibleEmbodimentCodes": [
      "string"
    ],
    "policyFamily": "string",
    "wireProtocols": [
      "string"
    ],
    "bundleStatus": "string",
    "bundleFailureCode": "string",
    "registeredAt": "string",
    "createdAt": "string",
    "updatedAt": "string",
    "trainedOn": {
      "projectVersionId": "string",
      "rigProfiles": [
        {
          "id": "string",
          "source": "team"
        }
      ],
      "resultsWithoutRigProfile": 0
    }
  }
}

Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1

{ "data": { "id": "string", "tenantId": "string", "projectId": "string", "modelImageDefinitionId": "string", "name": "string", "sourceType": "trained", "sourceTrainingJobId": "string", "artifactId": "string", "status": "draft", "paramsSnapshot": {}, "evalMetrics": {}, "compatibleEmbodimentCodes": [ "string" ], "policyFamily": "string", "wireProtocols": [ "string" ], "bundleStatus": "string", "bundleFailureCode": "string", "registeredAt": "string", "createdAt": "string", "updatedAt": "string", "trainedOn": { "projectVersionId": "string", "rigProfiles": [ { "id": "string", "source": "team" } ], "resultsWithoutRigProfile": 0 } } }