Orthogonal

Orthogonal Agent Mail API

The AgentMail API from Orthogonal — 14 operation(s) for agentmail.

GitHub OpenAPI

Operations 21

GET /agentmail/v0/inboxes/{inbox_id}/drafts/{draft_id} Get a specific draft including its full content, recipients, and attachments #
DELETE /agentmail/v0/inboxes/{inbox_id}/drafts/{draft_id} Permanently delete a draft. Important: pass method: "DELETE" in your run request #
PATCH /agentmail/v0/inboxes/{inbox_id}/drafts/{draft_id} Update an existing draft. #
POST /agentmail/v0/inboxes/{inbox_id}/drafts/{draft_id}/send Send an existing draft as an email. #
GET /agentmail/v0/inboxes/{inbox_id} Get details of a specific inbox including display name, creation date, and… #
PATCH /agentmail/v0/inboxes/{inbox_id} Update an existing inbox display name or client ID #
DELETE /agentmail/v0/inboxes/{inbox_id} Permanently delete an inbox and all its contents. #
GET /agentmail/v0/inboxes/{inbox_id}/threads/{thread_id} Get a thread and all its messages. #
DELETE /agentmail/v0/inboxes/{inbox_id}/threads/{thread_id} Move a thread to trash, or permanently delete if already trashed. #
GET /agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/raw Get the original raw RFC 2822 email content including all headers, MIME parts… #
PATCH /agentmail/v0/inboxes/{inbox_id}/messages/{message_id} Update labels on a message (e.g., mark as read, archive, star) #
GET /agentmail/v0/inboxes/{inbox_id}/messages/{message_id} Get a specific message including headers, body (text and HTML), attachments… #
POST /agentmail/v0/inboxes/{inbox_id}/drafts Create a new draft in an inbox. #
GET /agentmail/v0/inboxes/{inbox_id}/drafts List all drafts in an inbox. #
POST /agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/reply Reply to a specific message. #
POST /agentmail/v0/inboxes/{inbox_id}/messages/send Send an email message from an inbox. #
GET /agentmail/v0/inboxes/{inbox_id}/threads List all email threads in an inbox, ordered by most recent. #
POST /agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/forward Forward a message to new recipients. #
POST /agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/reply-all Reply to all recipients of a message. #
GET /agentmail/v0/inboxes/{inbox_id}/messages List all messages in an inbox, ordered by most recent. #
POST /agentmail/v0/inboxes Create a new email inbox. #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/orthogonal/refs/heads/main/openapi/orthogonal-agentmail-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/orthogonal-agentmail-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

orthogonal-agentmail-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Orthogonal API Marketplace Agent Mail API
  version: 1.0.0
  description: Discoverable APIs payable over MPP (Machine Payments Protocol / Tempo), x402, and np (Circle Gateway Nanopayments, x402 v2).
servers:
- url: https://mpp.orthogonal.com
  description: MPP (Tempo) rail
- url: https://x402.orthogonal.com
  description: x402 rail
- url: https://np.orthogonal.com
  description: np (Circle Gateway, x402 v2) rail
tags:
- name: AgentMail
paths:
  /agentmail/v0/inboxes/{inbox_id}/drafts/{draft_id}:
    get:
      operationId: agentmail_GET__v0_inboxes_inbox_id_drafts_draft_id_
      summary: Get a specific draft including its full content, recipients, and attachments
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
    delete:
      operationId: agentmail_DELETE__v0_inboxes_inbox_id_drafts_draft_id_
      summary: 'Permanently delete a draft. Important: pass method: "DELETE" in your run request'
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
    patch:
      operationId: agentmail_PATCH__v0_inboxes_inbox_id_drafts_draft_id_
      summary: Update an existing draft.
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
  /agentmail/v0/inboxes/{inbox_id}/drafts/{draft_id}/send:
    post:
      operationId: agentmail_POST__v0_inboxes_inbox_id_drafts_draft_id_send
      summary: Send an existing draft as an email.
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
  /agentmail/v0/inboxes/{inbox_id}:
    get:
      operationId: agentmail_GET__v0_inboxes_inbox_id_
      summary: Get details of a specific inbox including display name, creation date, and…
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
    patch:
      operationId: agentmail_PATCH__v0_inboxes_inbox_id_
      summary: Update an existing inbox display name or client ID
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
    delete:
      operationId: agentmail_DELETE__v0_inboxes_inbox_id_
      summary: Permanently delete an inbox and all its contents.
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
  /agentmail/v0/inboxes/{inbox_id}/threads/{thread_id}:
    get:
      operationId: agentmail_GET__v0_inboxes_inbox_id_threads_thread_id_
      summary: Get a thread and all its messages.
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
    delete:
      operationId: agentmail_DELETE__v0_inboxes_inbox_id_threads_thread_id_
      summary: Move a thread to trash, or permanently delete if already trashed.
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
  /agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/raw:
    get:
      operationId: agentmail_GET__v0_inboxes_inbox_id_messages_message_id_raw
      summary: Get the original raw RFC 2822 email content including all headers, MIME parts…
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
  /agentmail/v0/inboxes/{inbox_id}/messages/{message_id}:
    patch:
      operationId: agentmail_PATCH__v0_inboxes_inbox_id_messages_message_id_
      summary: Update labels on a message (e.g., mark as read, archive, star)
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
    get:
      operationId: agentmail_GET__v0_inboxes_inbox_id_messages_message_id_
      summary: Get a specific message including headers, body (text and HTML), attachments…
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
  /agentmail/v0/inboxes/{inbox_id}/drafts:
    post:
      operationId: agentmail_POST__v0_inboxes_inbox_id_drafts
      summary: Create a new draft in an inbox.
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
        '402':
          description: Payment Required (x402 / MPP / np)
      x-payment-info:
        price: 0.01
        offers:
        - method: mpp
          intent: charge
          rail: tempo
          currency: USDC.e
          url: https://mpp.orthogonal.com/agentmail/v0/inboxes/{inbox_id}/drafts
        - method: x402
          intent: charge
          rail: base
          currency: USDC
          url: https://x402.orthogonal.com/agentmail/v0/inboxes/{inbox_id}/drafts
        - method: np
          intent: charge
          rail: base
          currency: USDC
          settlement: circle-gateway
          version: x402-v2
          url: https://np.orthogonal.com/agentmail/v0/inboxes/{inbox_id}/drafts
    get:
      operationId: agentmail_GET__v0_inboxes_inbox_id_drafts
      summary: List all drafts in an inbox.
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
  /agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/reply:
    post:
      operationId: agentmail_POST__v0_inboxes_inbox_id_messages_message_id_reply
      summary: Reply to a specific message.
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
        '402':
          description: Payment Required (x402 / MPP / np)
      x-payment-info:
        price: 0.01
        offers:
        - method: mpp
          intent: charge
          rail: tempo
          currency: USDC.e
          url: https://mpp.orthogonal.com/agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/reply
        - method: x402
          intent: charge
          rail: base
          currency: USDC
          url: https://x402.orthogonal.com/agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/reply
        - method: np
          intent: charge
          rail: base
          currency: USDC
          settlement: circle-gateway
          version: x402-v2
          url: https://np.orthogonal.com/agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/reply
  /agentmail/v0/inboxes/{inbox_id}/messages/send:
    post:
      operationId: agentmail_POST__v0_inboxes_inbox_id_messages_send
      summary: Send an email message from an inbox.
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
        '402':
          description: Payment Required (x402 / MPP / np)
      x-payment-info:
        price: 0.01
        offers:
        - method: mpp
          intent: charge
          rail: tempo
          currency: USDC.e
          url: https://mpp.orthogonal.com/agentmail/v0/inboxes/{inbox_id}/messages/send
        - method: x402
          intent: charge
          rail: base
          currency: USDC
          url: https://x402.orthogonal.com/agentmail/v0/inboxes/{inbox_id}/messages/send
        - method: np
          intent: charge
          rail: base
          currency: USDC
          settlement: circle-gateway
          version: x402-v2
          url: https://np.orthogonal.com/agentmail/v0/inboxes/{inbox_id}/messages/send
  /agentmail/v0/inboxes/{inbox_id}/threads:
    get:
      operationId: agentmail_GET__v0_inboxes_inbox_id_threads
      summary: List all email threads in an inbox, ordered by most recent.
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
  /agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/forward:
    post:
      operationId: agentmail_POST__v0_inboxes_inbox_id_messages_message_id_forward
      summary: Forward a message to new recipients.
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
        '402':
          description: Payment Required (x402 / MPP / np)
      x-payment-info:
        price: 0.01
        offers:
        - method: mpp
          intent: charge
          rail: tempo
          currency: USDC.e
          url: https://mpp.orthogonal.com/agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/forward
        - method: x402
          intent: charge
          rail: base
          currency: USDC
          url: https://x402.orthogonal.com/agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/forward
        - method: np
          intent: charge
          rail: base
          currency: USDC
          settlement: circle-gateway
          version: x402-v2
          url: https://np.orthogonal.com/agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/forward
  /agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/reply-all:
    post:
      operationId: agentmail_POST__v0_inboxes_inbox_id_messages_message_id_reply_all
      summary: Reply to all recipients of a message.
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
        '402':
          description: Payment Required (x402 / MPP / np)
      x-payment-info:
        price: 0.01
        offers:
        - method: mpp
          intent: charge
          rail: tempo
          currency: USDC.e
          url: https://mpp.orthogonal.com/agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/reply-all
        - method: x402
          intent: charge
          rail: base
          currency: USDC
          url: https://x402.orthogonal.com/agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/reply-all
        - method: np
          intent: charge
          rail: base
          currency: USDC
          settlement: circle-gateway
          version: x402-v2
          url: https://np.orthogonal.com/agentmail/v0/inboxes/{inbox_id}/messages/{message_id}/reply-all
  /agentmail/v0/inboxes/{inbox_id}/messages:
    get:
      operationId: agentmail_GET__v0_inboxes_inbox_id_messages
      summary: List all messages in an inbox, ordered by most recent.
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
  /agentmail/v0/inboxes:
    post:
      operationId: agentmail_POST__v0_inboxes
      summary: Create a new email inbox.
      tags:
      - AgentMail
      responses:
        '200':
          description: Successful response
        '402':
          description: Payment Required (x402 / MPP / np)
      x-payment-info:
        price: 2
        offers:
        - method: mpp
          intent: charge
          rail: tempo
          currency: USDC.e
          url: https://mpp.orthogonal.com/agentmail/v0/inboxes
        - method: x402
          intent: charge
          rail: base
          currency: USDC
          url: https://x402.orthogonal.com/agentmail/v0/inboxes
        - method: np
          intent: charge
          rail: base
          currency: USDC
          settlement: circle-gateway
          version: x402-v2
          url: https://np.orthogonal.com/agentmail/v0/inboxes
x-service-info:
  name: Orthogonal
  docs:
    llms: https://api.orthogonal.com/llms.txt
  protocols:
  - mpp
  - x402
  - np