Submit a session action
POST/api/v1/:environment/sessions/:sessionId/actions
Submits a mid-workflow action for a running session step (e.g. validateOtp or resendOtp for PHONE_VERIFY:v1). Pass the x-ticket-id header with the value returned by GET /step to guard against replay. Returns 202 Accepted on success.
Request
Responses
- 202
- 400
- 401
- 403
- 404
- 409
- 500
Action accepted and forwarded to the workflow
Bad Request
Unauthorized - Invalid or missing Bearer token
Forbidden - Token does not have required permissions
Session not found
Stale ticket — the provided x-ticket-id does not match the current step state
Internal server error