Builds the image of a Python version: no build when it has no requirements (the platform base image is used), otherwise a queued cloud build (no reuse of an earlier version's image). Idempotent: a version with an image or an active build answers with it.
POST
/v1/algorithms/{algorithmId}/versions/{version}/buildscurl -X POST 'https://api.embodiflow.io/v1/algorithms/{algorithmId}/versions/{version}/builds' \
-H 'Authorization: Bearer $EMBODIFLOW_PAT'Authorization
Send a personal access token with every request.
- Authorization: Bearer PAT
Path parameters
- algorithmIdstringrequired
- versionstringrequired
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
Build status of the version: `data.build` is null when no build was needed; poll GET version for `build.state`.
- dataobjectrequired
- revisionIdstringrequired
- versionstringrequired
- imageDigeststring | nullrequired
- buildobjectrequired
Response example
{
"data": {
"revisionId": "string",
"version": "string",
"imageDigest": "string",
"build": {
"buildId": "string",
"state": "queued",
"reason": "pip_resolution",
"startedAt": "string",
"finishedAt": "string"
}
}
}Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1