Threads

Send Message

Send a message to a thread. This endpoint validates and queues the message for processing, then returns immediately with a success response. It does NOT wait for AI processing to complete. The actual AI response, including text, artifacts (tables, graphs), and completion status, is delivered asynchronously via the SSE stream at `/threads/stream/{thread_id}`. `source_overrides` is an optional parameter which is a JSON string that can be used to override the user's thread source settings. The JSON string is a dictionary with the following keys: - `update_default_settings`: bool (optional, default: false) - `web_search`: string (optional, default: null) - <small style="color: #999;">Allowed values:</small> <code style="background: #2d2d2d; color: #fff; padding: 3px 8px; border-radius: 6px; margin: 0 4px; border: 1px solid #3d3d3d; display: inline-block; font-size: 0.7em;">"all_sources"</code> <code style="background: #2d2d2d; color: #fff; padding: 3px 8px; border-radius: 6px; margin: 0 4px; border: 1px solid #3d3d3d; display: inline-block; font-size: 0.7em;">"off"</code> - `web_scraping`: string (optional, default: null) - <small style="color: #999;">Allowed values:</small> <code style="background: #2d2d2d; color: #fff; padding: 3px 8px; border-radius: 6px; margin: 0 4px; border: 1px solid #3d3d3d; display: inline-block; font-size: 0.7em;">"all_sources"</code> <code style="background: #2d2d2d; color: #fff; padding: 3px 8px; border-radius: 6px; margin: 0 4px; border: 1px solid #3d3d3d; display: inline-block; font-size: 0.7em;">"off"</code> - `filings`: string (optional, default: null) - <small style="color: #999;">Allowed values:</small> <code style="background: #2d2d2d; color: #fff; padding: 3px 8px; border-radius: 6px; margin: 0 4px; border: 1px solid #3d3d3d; display: inline-block; font-size: 0.7em;">"all_sources"</code> <code style="background: #2d2d2d; color: #fff; padding: 3px 8px; border-radius: 6px; margin: 0 4px; border: 1px solid #3d3d3d; display: inline-block; font-size: 0.7em;">"off"</code> - `earnings`: string (optional, default: null) - <small style="color: #999;">Allowed values:</small> <code style="background: #2d2d2d; color: #fff; padding: 3px 8px; border-radius: 6px; margin: 0 4px; border: 1px solid #3d3d3d; display: inline-block; font-size: 0.7em;">"all_sources"</code> <code style="background: #2d2d2d; color: #fff; padding: 3px 8px; border-radius: 6px; margin: 0 4px; border: 1px solid #3d3d3d; display: inline-block; font-size: 0.7em;">"off"</code> - `news`: string (optional, default: null) - <small style="color: #999;">Allowed values:</small> <code style="background: #2d2d2d; color: #fff; padding: 3px 8px; border-radius: 6px; margin: 0 4px; border: 1px solid #3d3d3d; display: inline-block; font-size: 0.7em;">"all_sources"</code> <code style="background: #2d2d2d; color: #fff; padding: 3px 8px; border-radius: 6px; margin: 0 4px; border: 1px solid #3d3d3d; display: inline-block; font-size: 0.7em;">"off"</code> See the [source overrides](/alfa-preview/source-overrides) documentation for more details.

Authentication

AuthorizationBearer
OAuth2 access token obtained via token exchange.

Path parameters

thread_idstringRequired

Request

This endpoint expects an object.
messagestringRequired
source_overridesstring or nullOptional

Response

Successful Response
successboolean or nullDefaults to true

Errors