API Referencemessages

Send Message Batch

Send 1..100 messages in one request. strict (default) rejects the whole batch with 422 if any item is invalid and sends nothing; permissive sends the valid items and returns a per-position error object for each invalid one.

Authentication

AuthorizationBearer
Your RRay API key.
OR
RRay-Workspace-Idstring

The workspace to act on. Required when your credential is account-level; ignored for workspace-scoped API keys, which already carry their workspace.

Headers

RRay-Batch-ValidationstringOptionalDefaults to strict

strict (default) 422s the whole batch if any item is invalid; permissive sends the valid items and returns per-position error-objects for the rest.

Idempotency-Keystring or nullOptional

Request

This endpoint expects a list of objects.
fromstringRequired
tolist of stringsRequired
cclist of strings or nullOptional
bcclist of strings or nullOptional
reply_tostring or list of strings or nullOptional
subjectstring or nullOptional
htmlstring or nullOptional
textstring or nullOptional
attachmentslist of objects or nullOptional

Response

Successful Response
summaryobject

Per-request tally so the caller can branch without scanning items. Endpoint- agnostic (total / success_count / error_count mirror the result discriminator) so every batch response across the API reuses this one model.

itemslist of objects

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
413
Content Too Large Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
502
Bad Gateway Error