other · Listed · Found · 8 endpoints · Not used for Gateway

API Reference

Listed

MPP endpoints published at https://docs.agentmail.to.

Not used for Gateway

Listed — live manifest, not yet verified · not used for Gateway Still catalogued — dead/unreachable knowledge is index value. (Listed — live manifest, not yet verified · not used for Gateway)

Indexed from this operator's public /.well-known/x402.json. Found is not operator-owned and is not attested. Claim or opt out.

Agent Read · Cleared Index

CAUTION

Caution — usable signal, incomplete attestation or mesh.

confidence

67%

source

signal

Index before you pay. Same payload for agents:
GET /api/cleared/agent-read?slug=api-reference-hbwz

When to call

MPP endpoints published at https://docs.agentmail.to.

Risks

Found — not operator-owned; claim status unknown.
No Cleared settlement receipt on file yet.
Endpoint response check pending or failed.
No Gateway traffic yet — market share unproven.

Price posture

8 endpoints — confirm price on manifest before pay.

Settle posture

Merona · UNKNOWN

trust data: merona.io · settlement mesh partner

Category · Gateway

other · no Gateway routes yet — early / unproven on Cleared market share.

Endpoint hints

POST /v0/agent/sign-up

Create a new agent organization with an inbox and API key. This endpoint is for signing up for the first time. If you've already signed up, you're all set — jus

Metered

POST /v0/agent/verify

Verify an agent organization using the 6-digit OTP sent to the human's email during sign-up. On success, the organization is upgraded from `agent_unverified` t

Metered

GET /v0/inboxes

**CLI:** ```bash agentmail inboxes list ```

Metered

POST /v0/inboxes

**CLI:** ```bash agentmail inboxes create --display-name "My Agent" --username myagent --domain agentmail.to ```

Metered

GET /v0/inboxes/{inbox_id}

**CLI:** ```bash agentmail inboxes get --inbox-id <inbox_id> ```

Metered

GET /v0/inboxes/{inbox_id}

**CLI:** ```bash agentmail inboxes update --inbox-id <inbox_id> --display-name "Updated Name" ```

Metered

GET /v0/inboxes/{inbox_id}

**CLI:** ```bash agentmail inboxes delete --inbox-id <inbox_id> ```

Metered

GET /v0/inboxes/{inbox_id}/threads

Lists threads in the inbox, most recent first. Pass `senders`, `recipients`, or `subject` to filter by substring. Filtered requests are served by search, which

Metered

Evidence (Cleared)

→ Intake listed · not used for Gateway
→ Trust 55/100 · fail · tier listed
→ Protocol mpp
→ Manifest reachable · schema valid
→ Found listing — indexed from public x402.json, not operator-attested.

originhttps://docs.agentmail.to

manifestx402.json

protocol

x402

Endpoints

Sign Up

Metered

POST https://docs.agentmail.to/v0/agent/sign-up

Create a new agent organization with an inbox and API key. This endpoint is for signing up for the first time. If you've already signed up, you're all set — just use your existing API key. A 6-digit OTP is sent to the human's email for verification. This endpoint is idempotent. Calling it again with the same `human_email` will rotate the API key and resend the OTP if expired. The returned API key has limited permissions until the organization is verified via the verify endpoint. **CLI:** ```bash agentmail agent sign-up --human-email user@example.com --username my-agent ```

Verify

Metered

POST https://docs.agentmail.to/v0/agent/verify

Verify an agent organization using the 6-digit OTP sent to the human's email during sign-up. On success, the organization is upgraded from `agent_unverified` to `agent_verified`, the send allowlist is removed, and free plan entitlements are applied. The OTP expires after 24 hours and allows a maximum of 10 attempts. If you run into any difficulties receiving the OTP code, you can also create an account on [console.agentmail.to](https://console.agentmail.to) using the human email address you provided to verify your account. **CLI:** ```bash agentmail agent verify --otp-code 123456 ```

List Inboxes

Metered

GET https://docs.agentmail.to/v0/inboxes

**CLI:** ```bash agentmail inboxes list ```

Create Inbox

Metered

POST https://docs.agentmail.to/v0/inboxes

**CLI:** ```bash agentmail inboxes create --display-name "My Agent" --username myagent --domain agentmail.to ```

Get Inbox

Metered

GET https://docs.agentmail.to/v0/inboxes/{inbox_id}

**CLI:** ```bash agentmail inboxes get --inbox-id <inbox_id> ```

Update Inbox

Metered

GET https://docs.agentmail.to/v0/inboxes/{inbox_id}

**CLI:** ```bash agentmail inboxes update --inbox-id <inbox_id> --display-name "Updated Name" ```

Delete Inbox

Metered

GET https://docs.agentmail.to/v0/inboxes/{inbox_id}

**CLI:** ```bash agentmail inboxes delete --inbox-id <inbox_id> ```

List Threads

Metered

GET https://docs.agentmail.to/v0/inboxes/{inbox_id}/threads

Lists threads in the inbox, most recent first. Pass `senders`, `recipients`, or `subject` to filter by substring. Filtered requests are served by search, which caps `limit` at 100. For relevance-ranked full-text search, use `Search Threads`. **CLI:** ```bash agentmail inboxes:threads list --inbox-id <inbox_id> ```

Checks

manifest

reachable

schema

valid

last checked

2026-08-25T01:03:04.236Z

Intake listed · Listed — live manifest, not yet verified · not used for Gateway · probed 0/3 · No settlement evidence found in chain signals.

Claim this listing to upgrade to Cleared attestation.

Claim listing