Enqueue message for async processing (Beta)
POST/v1/desks/:desk_id/sessions/:session_id/enqueue
Beta: This endpoint is in beta and may change without notice.
Enqueue a message for asynchronous processing. Unlike the synchronous /message endpoint, this returns immediately (202 Accepted) after the message is queued. The response will be delivered via the configured channel callback.
Benefits:
- Lower latency for the caller (no waiting for AI response)
- Better handling of slow or long-running responses
- Automatic retries on failure
Permissions -
desks.readandsessions.write. Only available for internal components.
Request
Responses
- 202
- 403
- 404
Message successfully enqueued for processing
Forbidden – session processor disabled or not an internal component
The specified resource was not found
Response Headers
X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example:
abc123xyz789