Skip to main content
POST
Reply to computer email

Authorizations

Authorization
string
header
required

A Cool Computers API key, user access token, or claimed agent access token in the Authorization header. Follow https://www.cool.computer/auth.md for agent registration and https://www.cool.computer/authentication.md for direct user credentials.

Headers

Idempotency-Key
string

A caller-generated key for safely retrying this side effect. The server retains the key and response for 24 hours. Reusing it with the same request replays the original response, except after a failure that proves nothing happened: that is kept for one minute, and one that sets Retry-After is not kept, so a retry after it runs the request again; reusing it with different input returns 409.

Required string length: 1 - 128
Pattern: ^[!-~]+$
Example:

"req_01J6M6Y9TF9Q9QF6M1ZP8K4R2A"

Path Parameters

id
string
required

The computer's name, such as agent-atlas, or its id (cmp_…). Every caller may use either, the computer's own runtime token included.

Minimum string length: 1
Example:

"agent-atlas"

emailID
string
required

Email identifier returned by the inbox list operation.

Minimum string length: 1
Example:

"eml_123"

Body

application/json
text
string
required

Plain-text reply body. The text and HTML bodies together are at most 128 KiB of UTF-8, without surrounding white space; a larger one is 413 email_body_too_large, whose context.field names the body to shorten.

Pattern: \S
html
string

HTML reply body. The text and HTML bodies together are at most 128 KiB of UTF-8, without surrounding white space; a larger one is 413 email_body_too_large, whose context.field names the body to shorten.

Response

Safe delivery metadata for the stored outbound reply.

id
string
required
status
enum<string>
required
Available options:
sent
created_at
string<date-time>
required