API Reference

Complete reference for the Agentry REST API.

View as Markdown

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

SurfaceBase URL
Agenthttps://api.agentry.to/agent/v0
Humanhttps://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.