Edge inference package (ADR 0072) — openpi_client + embodiment fail-closed.

POST

/v1/model-versions/{modelVersionId}/edge-inference-package

curl -X POST 'https://api.embodiflow.io/v1/model-versions/{modelVersionId}/edge-inference-package' \
  -H 'Authorization: Bearer $EMBODIFLOW_PAT' \
  -H 'Content-Type: application/json' \
  -d '{
    "embodimentProfileId": "00000000-0000-0000-0000-000000000000",
    "mode": "local",
    "strategyKey": "string",
    "remotePolicyHost": "string",
    "remotePolicyPort": 0,
    "steps": 0,
    "targetArch": "x86-cuda",
    "wireProtocols": "openpi-ws",
    "useFakeTransport": true
  }'

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.

Request body

Content-Typeapplication/json

embodimentProfileIdstring (uuid)required
modestringrequired
Allowed values
local
remote_ws
strategyKeystring
remotePolicyHoststring
remotePolicyPortnumber
stepsnumber
targetArchstring
Image line (ADR 0145 §6). Jetson is a separate line, not a platform.
Allowed values
x86-cuda
jetson-jp6
cpu
wireProtocolsarray<string>
Non-empty subset when provided; defaults to `openpi-ws` only.
useFakeTransportboolean

Responses

Success

dataobjectrequired
- schemaVersionstringrequired
  Allowed values
  embodiflow-edge-inference-package/v1
- modelVersionIdstringrequired
- tenantIdstringrequired
- projectIdstringrequired
- embodimentProfileIdstringrequired
- embodimentCodestringrequired
- modestringrequired
  Allowed values
  local
  remote_ws
- weightUrlsarray<string>required
- runtimeImagestring | nullrequired
- edgeConfigobjectrequired
- runCommandstringrequired
- docLinksobjectrequired
- generatedAtstringrequired
- expiresAtstringrequired
- targetArchstringrequired
  Allowed values
  x86-cuda
  jetson-jp6
  cpu
- wiresarray<EdgeWireEndpointDto>required
- hostRequirementsobjectrequired
- bundlePullobjectrequired
- securityNoticestring | nullrequired

Response example

{
  "data": {
    "schemaVersion": "embodiflow-edge-inference-package/v1",
    "modelVersionId": "string",
    "tenantId": "string",
    "projectId": "string",
    "embodimentProfileId": "string",
    "embodimentCode": "string",
    "mode": "local",
    "weightUrls": [
      "string"
    ],
    "runtimeImage": "string",
    "edgeConfig": {},
    "runCommand": "string",
    "docLinks": {},
    "generatedAt": "string",
    "expiresAt": "string",
    "targetArch": "x86-cuda",
    "wires": [
      {
        "protocol": "openpi-ws",
        "port": 0,
        "plaintext": false
      }
    ],
    "hostRequirements": {
      "targetArch": "x86-cuda",
      "gpuRuntime": "string",
      "dockerGpuFlag": "string",
      "minGpuMemoryGb": 0,
      "notes": [
        "string"
      ]
    },
    "bundlePull": {
      "bundleObjectPrefix": "string",
      "downloadSessionId": "string",
      "sessionToken": "string",
      "expiresAt": "string",
      "presignedUrls": [
        "string"
      ]
    },
    "securityNotice": "string"
  }
}

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