Send a message

Message your agent exactly as the dashboard chat does, and optionally hold the request open for the reply.

Requires the agent:message scope.

Response. | Code | Meaning | |---|---| | 202 | { requestId, deduplicated, notSent?, message? }. Queued; poll the message. With waitSeconds, message is the last state seen, and waitEnded (unauthorized or poll_failed) says when the wait stopped early. An unauthorized stop carries no message. | | 200 | Only with waitSeconds: message is terminal and replies is filled. | | 400 | Missing or empty text, text over 8,000 bytes, a non-string client id, a non-boolean interrupt or queue, queue together with interrupt, or a waitSeconds outside 0 to 120. | | 409 | rejected with a message: text over 4,000 characters, a client id with characters outside A-Za-z0-9_.:-, or an account that can't take work right now (a trial waiting for a card, or paused for payment). |

With interrupt: false and an unfinished earlier message, either code can carry notSent: true: requestId and message are then the earlier request's, and nothing new was sent.