Messages

Send a message

{ to, cc?, bcc?, subject, text?, html?, attachments?: [{ filename, content_type, content_base64 }], labels?, send_at?, data?, type?, agent_signature? }. Returns 202 with status: "queued", channel and delivery. data (a JSON object or array, at most 64 KB) and type (message, task, event) make it an agent message; text, html or data is required. A recipient can be a handle such as @acme/billing (422 handle_not_found). agent_signature is the agent’s own author signature (422 invalid_agent_signature; not with send_at). Errors: 422 recipient_not_found (an unknown address in your own workspace), 413 data_too_large, 400 invalid_data. With send_at (ISO, 1 minute to 30 days ahead) nothing is sent now: it creates a scheduled draft and returns 202 with the draft instead of a message. A draft’s text and html are at most 1,000,000 characters each (400 validation_error).

Permission: messages:send.

post/v1/inboxes/{id}/messages/send

Request

  • Base URL: https://api.agentboxd.com
  • URL: https://api.agentboxd.com/v1/inboxes/{id}/messages/send
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Request body

subjectstring required
textstring
htmlstring
labelsstring[]
send_atstring date-time
dataunknown
type'message' | 'task' | 'event'
agent_signaturestring

Response

OK

object required

Changes

No recorded changes to this operation across all 1 revision of this API.