Skip to main content

Documentation Index

Fetch the complete documentation index at: https://drin.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

The Drin REST API is reachable at:
https://api.drin.run
All endpoints are versioned under /v1 and speak JSON. The pages in this section are generated from the OpenAPI spec and include a live request console.

Conventions

Authentication

Authorization: Bearer <key>, plus X-Drin-Product for account-wide keys.

Errors

A consistent { "error": { "type", "message" } } envelope on any non-2xx.

Pagination

Every list endpoint returns a cursor page:
{
  "data": [ /* … */ ],
  "nextCursor": "eyJpZCI6…"
}
Pass ?limit= (page size) and ?cursor= (from the previous nextCursor). When nextCursor is null, you’ve reached the end. The SDKs and CLI auto-paginate.

Idempotency

Send an Idempotency-Key header on a POST to make it safe to retry; the same key replays the original result for 24 hours. See Authentication.

Status codes

CodeMeaning
200 / 201Success.
202Accepted — the send was queued (returns a message id).
207Multi-status — a batch where items can individually succeed or fail.
204Success, no body (e.g. a delete).
4xxYour request — see Errors.
5xxOur side — safe to retry idempotently.

Send your first request

The quickstart walks through a real POST /v1/emails.