Create or reuse a cached version export

Authorization

Send a personal access token with every request.

• Authorization: Bearer PAT

Path parameters

• projectIdstringrequired
• versionNumbernumberrequired

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

• formatstringrequired

  The format the project's bound export workflow writes (preview `workflow.format`): lerobot-v3 for the platform LeRobot exporter, workflow for a team export algorithm.

  Allowed values

  lerobot-v3

  lerobot-v21

  original

  mp4-json

  rlds

  hdf5-robomimic

  workflow
• paramsobject

  Values for the bound export workflow's own parameters (preview `workflow.params`); a name it does not declare is refused with EXPORT_OPTION_UNSUPPORTED.

• optionsobject
  Hide child attributes
  • episodePerstring
    Allowed values

    episode

    subtask
  • includeDerivedActionboolean
  • includeImagesboolean

    Embed camera frames in the file; meaningful for hdf5-robomimic.

  • includeLabelsboolean
  • splitsarray<string>
  • taskLanguagestring
    Allowed values

    en

    zh
  • videoCodecstring
    Allowed values

    av1

    h264

    keep
  • maxWidthnumber

    Camera width after export; 0 keeps the native size. Absent means 1024 for human projects and native for robot projects.

Responses

{
  "data": {
    "id": "string",
    "format": "string",
    "options": {},
    "state": "queued",
    "loadCheck": "passed",
    "loadCheckError": "string",
    "sizeBytes": 0,
    "createdAt": "string",
    "workflowRunId": "string",
    "progress": {}
  }
}