Flow

Stage a file for a running execution

POST
/flows/{flow}/executions/{execution}:upload

Stores a single file under the execution's staging directory and returns the in-container path. Use this before POST :respond for any file-input widget: upload each file, then embed the returned path(s) into the respond JSON under data.<widget-name> as a string[].

Returns 404 if the execution does not exist or is not running on this node, 409 if it is in a terminal state, and 413 if the file exceeds the configured cap.

BearerAuth
headerAuthorizationBearer <JWT>

Admin token, API token issued via /api-tokens, or an OIDC JWT access token issued by the configured OIDC provider.

flow*string
Formatuuid
execution*string
Formatuuid
multipart/form-data
  1. body
file*unknown

The file to stage.

Response Body

The in-container path of the staged file.

application/json
  1. response
path*string

In-container path of the staged file, e.g. /uploads/<request-id>/<filename>. Embed this string into :respond body's data.<widget-name> array.

fileId*string

Stable identifier for the persisted file. Use with GET /files/{file} to download the file later.

Formatuuid
Example Request
curl -X POST 'https://example.com/api/hub/flows/497f6eca-6276-4993-bfeb-53cbbbba6f08/executions/497f6eca-6276-4993-bfeb-53cbbbba6f08:upload' \  -F 'file=null'
Example Response
{  "path": "string",  "fileId": "a1c6a2ab-4b01-4253-b4c9-70e04b3b48fc"}