GET /emails/{email_id}
Get an email and its retained timeline
API key (Bearer), on the public API endpoint.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
email_id | path | string · required | |
project_id | query | string | Required in a console session; ignored with an API key (the key's project). |
Responses
| Status | Description | Body |
|---|---|---|
200 | Project email | EmailJournalEntry |
403 | Scopes mail:send and job:read required | |
404 | email_not_found | |
503 | mail_journal_unavailable |
Examples
curl
curl -X GET "$GALON_API_BASE/emails/<email_id>" \
-H "Authorization: Bearer $GALON_API_KEY"Node.js (SDK)
import { Galon } from "galon";
const galon = new Galon(process.env.GALON_API_KEY);
const result = await galon.emails.get("<id>");Python (SDK)
from galon import Galon
galon = Galon() # reads GALON_API_KEY
result = galon.emails.get("<id>")PATCH /emails/{email_id}
Reschedule an email before the worker picks it up
Only scheduled_at can be modified, and only on a send that is already scheduled and still unclaimed. The new UTC time must remain within the next 72 hours.
API key (Bearer), on the public API endpoint.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
email_id | path | string · required |
Request body
application/json · schema EmailUpdate
| Field | Type | Description |
|---|---|---|
scheduled_at | string · required |
Responses
| Status | Description | Body |
|---|---|---|
200 | Send rescheduled atomically | EmailUpdateResponse |
403 | scope_missing (mail:send) | |
404 | email_not_found | |
409 | email_not_editable | |
413 | body_too_large | |
422 | email_schedule_invalid | |
503 | mail_unavailable |
Examples
curl
curl -X PATCH "$GALON_API_BASE/emails/<email_id>" \
-H "Authorization: Bearer $GALON_API_KEY" \
-H "Content-Type: application/json" \
-d '{"scheduled_at": "2026-11-11T12:00:00Z"}'Node.js (SDK)
import { Galon } from "galon";
const galon = new Galon(process.env.GALON_API_KEY);
const result = await galon.emails.update("<id>", {"scheduled_at": "2026-11-11T12:00:00Z"});Python (SDK)
from galon import Galon
galon = Galon() # reads GALON_API_KEY
result = galon.emails.update("<id>", {"scheduled_at": "2026-11-11T12:00:00Z"})