MultiMail .well Known API

The .well Known API from MultiMail — 4 operation(s) for .well known.

GitHub OpenAPI

Operations 4

GET /.well-known/multimail-signing-key Public signing key for identity verification #
GET /.well-known/reputation/{hash} Look up agent mailbox reputation by hash #
GET /.well-known/oauth-protected-resource Protected resource metadata (RFC 9728) #
GET /.well-known/oauth-authorization-server Authorization server metadata with agent_auth block #

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/multimail-dev:multimail-dev-well-known-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

multimail-dev-well-known-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: MultiMail .well Known API
  version: 2.0.0
  description: Email-as-a-Service for AI agents. Inbound email converted to markdown, outbound markdown converted to HTML. Built on Cloudflare Workers.
servers:
- url: https://api.multimail.dev
tags:
- name: .well Known
paths:
  /.well-known/multimail-signing-key:
    get:
      summary: Public signing key for identity verification
      description: Returns the ECDSA P-256 public key used to sign X-MultiMail-Identity headers.
      responses:
        '200':
          description: Public key document
      tags:
      - .well Known
      operationId: getWellKnownMultimailSigningKey
      x-operation-id-source: derived
  /.well-known/reputation/{hash}:
    get:
      summary: Look up agent mailbox reputation by hash
      description: Rate-limited to 10 lookups per IP per hour.
      parameters:
      - name: hash
        in: path
        required: true
        schema:
          type: string
          pattern: ^[a-f0-9]{64}$
      responses:
        '200':
          description: Reputation data
        '404':
          description: No reputation data found
        '429':
          description: Rate limit exceeded
      tags:
      - .well Known
      operationId: getWellKnownReputationByHash
      x-operation-id-source: derived
  /.well-known/oauth-protected-resource:
    get:
      summary: Protected resource metadata (RFC 9728)
      description: Returns metadata about MultiMail as an OAuth-protected resource, including supported scopes and authorization servers. Part of the auth.md agent registration protocol.
      responses:
        '200':
          description: Protected resource metadata
          content:
            application/json:
              schema:
                type: object
                properties:
                  resource:
                    type: string
                  resource_name:
                    type: string
                  resource_logo_uri:
                    type: string
                  resource_documentation:
                    type: string
                  scopes_supported:
                    type: array
                    items:
                      type: string
                  authorization_servers:
                    type: array
                    items:
                      type: string
                  bearer_methods_supported:
                    type: array
                    items:
                      type: string
      tags:
      - .well Known
      operationId: getWellKnownOauthProtectedResource
      x-operation-id-source: derived
  /.well-known/oauth-authorization-server:
    get:
      summary: Authorization server metadata with agent_auth block
      description: Returns OAuth authorization server metadata with an agent_auth extension block describing the auth.md agent registration flow.
      responses:
        '200':
          description: Authorization server metadata
          content:
            application/json:
              schema:
                type: object
                properties:
                  issuer:
                    type: string
                  agent_auth:
                    type: object
                    properties:
                      skill:
                        type: string
                      register_uri:
                        type: string
                      claim_uri:
                        type: string
                      identity_types_supported:
                        type: array
                        items:
                          type: string
                      identity_assertion:
                        type: object
      tags:
      - .well Known
      operationId: getWellKnownOauthAuthorizationServer
      x-operation-id-source: derived
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API key (mm_live_...). Keys have scopes: read (list/read emails, mailboxes, contacts), send (send/reply/cancel emails), admin (manage mailboxes, API keys, billing, account), oversight (approve/reject pending emails).'