Issue Upload Token

Issue a short-lived upload token for a paused Human Input form. Requires WebApp delivery.

POST /form/human_input/{form_token}/upload-token

Error

A valid request URL is required to generate request examples

200

{
  "upload_token": "hitl_upload_dGhpcy1pcy1hbi1leGFtcGxlLXRva2Vu",
  "expires_at": 1745510400
}

Authorizations

Authorization · string · header · required

API Key authentication. For all API requests, include your API Key in the Authorization HTTP Header, prefixed with Bearer. Example: Authorization: Bearer {API_KEY}. Strongly recommend storing your API Key on the server-side, not shared or stored on the client-side, to avoid possible API-Key leakage that can lead to serious consequences.

Path Parameters

form_token · string · required

Access token for the paused form, returned in the human_input_required event from the Run Workflow or Send Chat Message endpoint in streaming mode.

Response

200

application/json

Upload token issued successfully.

upload_token · string

Pass as a Bearer token on Upload Local File and Upload Remote File to attach files to the form's file or file-list inputs.

expires_at · integer<int64>

Unix timestamp (seconds) after which upload_token is no longer accepted.