# Agentline API API

**Canonical:** https://apis.io/apis/agentline-nz/agentline-api-api/  
**Provider:** Agentline NZ — https://apis.io/providers/agentline-nz/  
**Base URL:** https://agentline.nz/api/v1  
**Documentation:** https://agentline.nz/changelog

Agentline API API is one of 2 APIs that [Agentline NZ](https://apis.io/providers/agentline-nz/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Email inboxes for AI agents: send and read email and wait for one-time codes. Texting is coming soon; the SMS, calls, voice and owner mobile endpoints are not available yet. Successful authenticated responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset. Every 429 includes Retry-

## Operations (24)

| Method | Path | Summary |
|---|---|---|
| GET | `/me` | Account, inboxes and usage |
| GET | `/sms` | List SMS (coming soon: texting is not available yet) |
| POST | `/sms` | Send SMS (coming soon: texting is not available yet) |
| GET | `/sms/{id}` | Read SMS (coming soon: texting is not available yet) |
| GET | `/emails` | List emails |
| POST | `/emails` | Send email |
| GET | `/emails/{id}` | Read email (doesn't change read state) |
| POST | `/mark-read` | Mark emails read, or unread |
| GET | `/emails/{id}/raw` | Original RFC 822 message |
| POST | `/wait-for-code` | Wait for a one-time code to arrive in the inbox |
| GET | `/calls` | List calls (coming soon: calls are not available yet) |
| POST | `/calls` | Place a call (coming soon: calls are not available yet) |
| POST | `/signup` | Agent self-signup (no auth, one call). Returns a working account straight away and emails the owner a verification link. Opening that link gives the key full... |
| GET | `/voice` | Call settings (coming soon: calls are not available yet) |
| PATCH | `/voice/{number_id}` | Update call settings (coming soon: calls are not available yet) |
| GET | `/keys` | List API keys |
| POST | `/keys` | Create an API key (secret returned once) |
| DELETE | `/keys/{id}` | Revoke an API key |
| POST | `/owner/verify` | Confirm the owner's mobile with a code (coming soon: texting is not available yet; only the emailed link verifies the account) |
| POST | `/owner/phone` | Start owner mobile verification (coming soon: texting is not available yet) |
| GET | `/audit` | Recent audit log entries |
| GET | `/billing` | Plan, status, trial and allowances |
| POST | `/billing/checkout` | Emails the owner a Stripe Checkout link to start a paid plan, and returns it |
| POST | `/billing/portal` | Stripe Customer Portal URL, also emailed to the owner. Plan changes or cancellation in the next 24 hours are emailed to the owner. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/agentline-nz/openapi/_original/agentline-nz-api-openapi.json
- **JSONSchema** — https://artifacts.apis.io/agentline-nz/json-schema/agentline-nz-me-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentline-nz/json-schema/agentline-nz-signup-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentline-nz/json-schema/agentline-nz-billing-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentline-nz/json-schema/agentline-nz-email-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentline-nz/json-schema/agentline-nz-email-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentline-nz/json-schema/agentline-nz-call-schema.json

## Other Agentline NZ APIs (1)

- [Agentline API](https://apis.io/apis/agentline-nz/agentline-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/agentline-nz/agentline-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/agentline-nz/.