Submit a workflow session for processing
Finalizes a `pending` session and queues its linked submission for asynchronous processing. Before transitioning the session, the API verifies that the expected files were actually uploaded to R2 (an `HTTP HEAD` is issued per file). If fewer than the workflow's `minFiles` files are present and non-empty, the request fails with `422` (see that response). File verification runs before the session-expiration check. An expired session with missing files therefore returns `422 files-missing`; an expired session returns `410` only after file verification passes. Session-state errors return distinct status codes: - `400` — the session cannot be submitted in its current state. This includes a session that was already submitted or completed, a session that has no linked submission or workflow, and any non-`pending` state other than `expired`. - `410` — the session has expired (either already marked `expired` or past its TTL at submit time). - `404` — the session does not exist, is not visible to the caller's API key, or does not belong to the workflow in the path.
/api/v1/workflows/{slug}/sessions/{sessionId}/submitAuthorization
AuthorizationRequiredBearer <token>Steve API key, usually scoped to a company. Legacy keys and keys created by platform administrators may be unscoped; company-scoped endpoints reject unscoped keys with 403 Forbidden. Format: Authorization: Bearer aok_...
In: header
Path Parameters
slugRequiredstringWorkflow slug.
sessionIdRequiredstringSteve session identifier.
Header Parameters
X-Request-IdstringOptional caller-supplied request identifier. Maximum length is 128 characters.
128Session submitted for processing