---
title: API Reference
description: Complete reference for the Agentry REST API.
---

Agentry exposes three API sections:

- **Agent** (`/agent/v0`) for hosted Agent Inboxes and AgentMail-compatible workflows.
- **Human** (`/human/v0`) for connected Human Inboxes and smart routing/context.
- **Organization** for shared tenant-level resources (for example pods).

Use this page as the top-level map, then use the section-specific overviews for exact contracts.

## Shared API shape

- Authentication: `Authorization: Bearer ag_...`
- Cursor pagination via `limit` and `page_token`
- Standard JSON error payloads
- OpenAPI-described request/response contracts

## Base URLs

| Surface | Base URL |
| ------- | -------- |
| Agent | `https://api.agentry.to/agent/v0` |
| Human | `https://api.agentry.to/human/v0` |

## Routing note

Organization resources are currently available via Agent namespace routes and documented in the **Organization** section to make the shared model explicit.

Websocket transport is documented in Guides and is not listed in this REST API reference tree.