Stage a file for a running execution
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.
BearerAuthAuthorizationBearer <JWT>Admin token, API token issued via /api-tokens, or an OIDC JWT access token issued by the configured OIDC provider.
flow*stringuuidexecution*stringuuidmultipart/form-data- body
file*unknownThe file to stage.
The in-container path of the staged file.
application/json- response
path*stringIn-container path of the staged file, e.g. /uploads/<request-id>/<filename>. Embed this string into :respond body's data.<widget-name> array.
fileId*stringStable identifier for the persisted file. Use with GET /files/{file} to download the file later.
uuidcurl -X POST 'https://example.com/api/hub/flows/497f6eca-6276-4993-bfeb-53cbbbba6f08/executions/497f6eca-6276-4993-bfeb-53cbbbba6f08:upload' \ -F 'file=null'{ "path": "string", "fileId": "a1c6a2ab-4b01-4253-b4c9-70e04b3b48fc"}