Galon Cloud
Galon API v1

/emails/{email_id}

Base URL https://api.galon.ai/v1 · export GALON_API_BASE="https://api.galon.ai/v1"

GET /emails/{email_id}

Get an email and its retained timeline

API key (Bearer), on the public API endpoint.

Parameters

NameInTypeDescription
email_idpathstring · required
project_idquerystringRequired in a console session; ignored with an API key (the key's project).

Responses

StatusDescriptionBody
200Project emailEmailJournalEntry
403Scopes mail:send and job:read required
404email_not_found
503mail_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

NameInTypeDescription
email_idpathstring · required

Request body

application/json · schema EmailUpdate

FieldTypeDescription
scheduled_atstring · required

Responses

StatusDescriptionBody
200Send rescheduled atomicallyEmailUpdateResponse
403scope_missing (mail:send)
404email_not_found
409email_not_editable
413body_too_large
422email_schedule_invalid
503mail_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"})