> ## Documentation Index
> Fetch the complete documentation index at: https://docs.12m.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference

> REST over JSON. Bearer-token auth. Identity in the URL path.

The 12m public API is REST over JSON. Every endpoint takes a Bearer
token and an identity handle in the URL path; everything else is request
body or query string.

```
Base URL:   https://api.inboxbase.ai
Versioning: /v1/...
Auth:       Authorization: Bearer sk_live_...
```

## Conventions

* **Content type.** All requests and responses are
  `application/json`. We don't accept form-encoded bodies.
* **Time.** All timestamps are returned both as Unix milliseconds (`ts`,
  `lastEventAt`, `createdAt`) and ISO 8601 strings (`tsIso`,
  `lastEventAtIso`, `createdAtIso`). Pick whichever your stack prefers.
* **Identifiers.** Conversation ids look like `conv_<16hex>`, event
  ids like `evt_<26char ULID>`, account ids like `acc_<16hex>`. They're
  opaque; treat as strings.
* **Pagination.** Listing endpoints return `nextCursor` (or `null`)
  alongside the page. Pass it back as `cursor` on the next call.
* **Errors.** JSON with an `error` string and an optional `details`
  field. See [Errors](/api-reference/errors) for the full table.

## Endpoints

<CardGroup cols={2}>
  <Card title="POST /send" icon="paper-plane" href="/api-reference/send">
    Send a new conversation, or reply by `convId`. Idempotent on
    `Idempotency-Key`.
  </Card>

  <Card title="GET /conversations" icon="list" href="/api-reference/list-conversations">
    List threads in an identity with filters and pagination.
  </Card>

  <Card title="GET /conversations/:convId" icon="message" href="/api-reference/get-conversation">
    Full timeline for one conversation.
  </Card>

  <Card title="GET /events" icon="bolt" href="/api-reference/events">
    Cursor-based stream of every customer-observable event on an identity.
    Long-poll up to 25 seconds.
  </Card>
</CardGroup>

## Webhooks

<CardGroup cols={2}>
  <Card title="Configure" icon="webhook" href="/api-reference/webhooks-overview">
    Set the URL, manage the signing secret, retry behavior.
  </Card>

  <Card title="Verify" icon="lock" href="/api-reference/webhooks-verify">
    HMAC-SHA256 signature verification with a 5-minute window.
  </Card>
</CardGroup>