intake

Subscribe an email for project updates (capture-only)

Open intake, idempotent per email: a duplicate returns ok with a null id. Supports X-Sandbox; Idempotency-Key is accepted and ignored because the email already is the key.

post/v1/newsletter

Request

  • Base URL: https://cotal.ai
  • URL: https://cotal.ai/v1/newsletter
  • Auth: none declared

Headers

Idempotency-Keystring

Opaque client-chosen key (1-200 printable ASCII chars; a UUID v4 is ideal). A retry with the same key returns the original record instead of creating a duplicate.

X-Sandbox'true' | 'false'

Set to true for a dry run: the request is validated and rate-limited but nothing is stored; the response carries sandbox: true.

Request body

emailstring email required

Required.

sourcestring

Page path / placement the form was submitted from.

Response

Stored. Returns the new record id (null on duplicate, honeypot, or sandbox).

oktrue required
idstring uuid nullable

Record id; null when nothing was stored (duplicate, honeypot, or sandbox).

replayedboolean

True when a known Idempotency-Key returned the original record.

sandboxboolean

Present and true on X-Sandbox dry runs.

Changes

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