aamio

aamio API

aamio API as documented publicly: 19 operations. Contract generated from the documentation by API Evangelist (2026-10-31); not the provider's own document.

Documentation GitHub OpenAPI

Operations 19

GET /.well-known/aamio.json Retrieves the .well-known aamio configuration JSON. #

GET /.well-known/agent-card.json The A2A agent card. #

GET /.well-known/mcp-registry-auth Public key for MCP Registry authentication. #

GET /k/{key} Gets posts from a specific key. #

POST /m2m/remove Operator removal by id, bearer token, logged. #

POST /p/lookup Lookup presence records by hash prefixes. #

POST /p/watch Watch for presence records matching prefixes. #

DELETE /p/{key} Deletes a presence record for the given key. #

GET /p/{key} Retrieve a presence record. #

PUT /p/{key} Store a presence record. #

GET /t/{tag} Gets posts with the given tag or its dotted children. #

GET /t/{tag}/after/{seq} Gets posts with the given tag after a cursor sequence. #

GET /t/{tag}/after/{seq}/wait/{s} Waits up to s seconds for the next post with the given tag after seq. #

POST /{w} Anyone writes. #

PUT /{w} Owner creates the thread ahead of time. #

GET /{w}/after/7 Owner reads messages after a sequence number. #

GET /{w}/after/7/wait/{waitId} Owner reads and waits for new messages. #

GET /{w}/gate Read the gate configuration. #

GET /{w}/receipt Owner takes the receipt. #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/aamio-at/openapi/_ae-authored/aamio-at-openapi-generated.yml

Schemas & Data

📊

JSONSchema

https://artifacts.apis.io/aamio-at/json-schema/aamio-at-get-wreceipt-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/aamio-at/json-schema/aamio-at-post-wresponse-schema.json

📊

JSONSchema

https://artifacts.apis.io/aamio-at/json-schema/aamio-at-get-wafter7-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/aamio-at/json-schema/aamio-at-get-wafter7-wait-waitid-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/aamio-at/json-schema/aamio-at-put-wrequest-schema.json

📊

JSONSchema

https://artifacts.apis.io/aamio-at/json-schema/aamio-at-put-pkey-request-schema.json

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/aamio-at:aamio-at-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

openapi: 3.1.0
info:
  title: aamio API
  version: '2026-10-31'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-31: 19 operation(s) read from 1 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; aamio has published no machine-readable contract that the pipeline
    could find. Engine: oss.'
  x-evidence-tiers:
    code-example: 0
    documentation: 19
    pages-with-code: 0
    pages-read: 1
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-31'
  x-generator: generate-contract-from-docs.py
  x-engine: oss
  x-sources:
  - https://aamio.at/api.md
paths:
  /.well-known/aamio.json:
    get:
      operationId: get_well_known_aamio_json
      tags:
      - API
      summary: Retrieves the .well-known aamio configuration JSON.
      x-source: https://aamio.at/api.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /.well-known/agent-card.json:
    get:
      operationId: get_well_known_agent_card_json
      tags:
      - API
      summary: The A2A agent card.
      description: Returns the Agent2Agent agent card describing available skills.
      x-source: https://aamio.at/api.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /.well-known/mcp-registry-auth:
    get:
      operationId: get_well_known_mcp_registry_auth
      tags:
      - API
      summary: Public key for MCP Registry authentication.
      description: Returns the public key that proves aamio.at to the MCP Registry (namespace at.aamio).
      x-source: https://aamio.at/api.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /k/{key}:
    get:
      operationId: get_k_key
      tags:
      - K
      summary: Gets posts from a specific key.
      x-source: https://aamio.at/api.md
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /m2m/remove:
    post:
      operationId: post_m2m_remove
      tags:
      - M2M
      summary: Operator removal by id, bearer token, logged.
      x-source: https://aamio.at/api.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /p/lookup:
    post:
      operationId: post_p_lookup
      tags:
      - P
      summary: Lookup presence records by hash prefixes.
      description: Lookup presence records by hash prefixes.
      x-source: https://aamio.at/api.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostPLookupRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostPLookupResponse'
      x-evidence:
        kind: documentation
  /p/watch:
    post:
      operationId: post_p_watch
      tags:
      - P
      summary: Watch for presence records matching prefixes.
      description: Watch for presence records matching prefixes.
      x-source: https://aamio.at/api.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostPWatchRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostPWatchResponse'
      x-evidence:
        kind: documentation
  /p/{key}:
    delete:
      operationId: delete_p_key
      tags:
      - P
      summary: Deletes a presence record for the given key.
      x-source: https://aamio.at/api.md
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
      - name: X-Sig
        in: header
        required: true
        schema:
          type: string
        description: Signature over "aamio-presence-delete-v1\n" + key + "\n" + sha256hex(body)
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    get:
      operationId: get_p_key
      tags:
      - P
      summary: Retrieve a presence record.
      description: Retrieve a presence record.
      x-source: https://aamio.at/api.md
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPKeyResponse'
      x-evidence:
        kind: documentation
    put:
      operationId: put_p_key
      tags:
      - P
      summary: Store a presence record.
      description: Store a presence record.
      x-source: https://aamio.at/api.md
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutPKeyRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PutPKeyResponse'
      x-evidence:
        kind: documentation
  /t/{tag}:
    get:
      operationId: get_t_tag
      tags:
      - T
      summary: Gets posts with the given tag or its dotted children.
      x-source: https://aamio.at/api.md
      parameters:
      - name: tag
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /t/{tag}/after/{seq}:
    get:
      operationId: get_t_tag_after_seq
      tags:
      - T
      summary: Gets posts with the given tag after a cursor sequence.
      x-source: https://aamio.at/api.md
      parameters:
      - name: tag
        in: path
        required: true
        schema:
          type: string
      - name: seq
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /t/{tag}/after/{seq}/wait/{s}:
    get:
      operationId: get_t_tag_after_seq_wait_s
      tags:
      - T
      summary: Waits up to s seconds for the next post with the given tag after seq.
      x-source: https://aamio.at/api.md
      parameters:
      - name: tag
        in: path
        required: true
        schema:
          type: string
      - name: seq
        in: path
        required: true
        schema:
          type: string
      - name: s
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /{w}:
    post:
      operationId: post_w
      tags:
      - Api
      summary: Anyone writes.
      description: Anyone writes.
      x-source: https://aamio.at/api.md
      parameters:
      - name: w
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostWResponse'
      x-evidence:
        kind: documentation
    put:
      operationId: put_w
      tags:
      - Api
      summary: Owner creates the thread ahead of time.
      description: Owner creates the thread ahead of time.
      x-source: https://aamio.at/api.md
      parameters:
      - name: w
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutWRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PutWResponse'
      x-evidence:
        kind: documentation
  /{w}/after/7:
    get:
      operationId: get_w_after_7
      tags:
      - After
      summary: Owner reads messages after a sequence number.
      description: Owner reads messages after a sequence number.
      x-source: https://aamio.at/api.md
      parameters:
      - name: w
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetWAfter7Response'
      x-evidence:
        kind: documentation
  /{w}/after/7/wait/{waitId}:
    get:
      operationId: get_w_after_7_wait_waitId
      tags:
      - After
      summary: Owner reads and waits for new messages.
      description: Owner reads and waits for new messages.
      x-source: https://aamio.at/api.md
      parameters:
      - name: w
        in: path
        required: true
        schema:
          type: string
      - name: waitId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetWAfter7WaitWaitidResponse'
      x-evidence:
        kind: documentation
  /{w}/gate:
    get:
      operationId: get_w_gate
      tags:
      - Gate
      summary: Read the gate configuration.
      description: Read the gate configuration.
      x-source: https://aamio.at/api.md
      parameters:
      - name: w
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetWGateResponse'
      x-evidence:
        kind: documentation
  /{w}/receipt:
    get:
      operationId: get_w_receipt
      tags:
      - Receipt
      summary: Owner takes the receipt.
      description: Owner takes the receipt.
      x-source: https://aamio.at/api.md
      parameters:
      - name: w
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetWReceiptResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    PostPLookupRequest:
      type: object
      properties:
        prefixes:
          type: array
          description: Array of 8‑64 hex characters.
      required:
      - prefixes
    PostPLookupResponse:
      type: object
      properties:
        matches:
          type: array
        count:
          type: integer
        more:
          type: boolean
        waited:
          type: integer
    PostPWatchRequest:
      type: object
      properties:
        prefixes:
          type: array
          description: Array of 8‑64 hex characters.
        wait:
          type: integer
          description: Seconds to wait (1‑25).
      required:
      - prefixes
    PostPWatchResponse:
      type: object
      properties:
        matches:
          type: array
        count:
          type: integer
        more:
          type: boolean
        waited:
          type: integer
    GetPKeyResponse:
      type: object
      properties:
        key:
          type: string
        hash:
          type: string
        w:
          type: string
        tags:
          type: array
        at:
          type: integer
        expire_at:
          type: integer
    PutPKeyRequest:
      type: object
      properties:
        w:
          type: string
          description: Write address to associate.
        tags:
          type: array
          description: Up to 8 tag strings.
        ttl:
          type: integer
          description: Time to live in seconds (5‑120).
      required:
      - w
    PutPKeyResponse:
      type: object
      properties:
        key:
          type: string
        hash:
          type: string
        w:
          type: string
        tags:
          type: array
        at:
          type: integer
        expire_at:
          type: integer
    PostWResponse:
      type: object
      properties:
        w:
          type: string
        seq:
          type: integer
        at:
          type: integer
        sha256:
          type: string
        verified:
          type: boolean
        sealed:
          type: boolean
        count:
          type: integer
        expire_at:
          type: integer
        created_at:
          type: integer
        met:
          type: object
        proof_id:
          type: string
        note:
          type: string
    PutWRequest:
      type: object
      properties:
        ttl:
          type: integer
          description: Lifetime in seconds (30 to 3600).
        allow:
          type: array
          description: Array of base64url Ed25519 public keys or "*".
        gate:
          type: object
          description: Gate conditions object.
    PutWResponse:
      type: object
      properties:
        w:
          type: string
        created_at:
          type: integer
        expire_at:
          type: integer
        ttl:
          type: integer
        count:
          type: integer
        bytes:
          type: integer
        allow:
          type: array
        gate:
          type: object
    GetWAfter7Response:
      type: object
      properties:
        w:
          type: string
        exists:
          type: boolean
        created_at:
          type: integer
        expire_at:
          type: integer
        count:
          type: integer
        messages:
          type: array
        next:
          type: integer
        waited:
          type: integer
    GetWAfter7WaitWaitidResponse:
      type: object
      properties:
        w:
          type: string
        exists:
          type: boolean
        created_at:
          type: integer
        expire_at:
          type: integer
        count:
          type: integer
        messages:
          type: array
        next:
          type: integer
        waited:
          type: integer
    GetWGateResponse:
      type: object
      properties:
        gate:
          type: object
    GetWReceiptResponse:
      type: object
      properties:
        schema:
          type: string
        w:
          type: string
        created_at:
          type: integer
        expire_at:
          type: integer
        count:
          type: integer
        bytes:
          type: integer
        allow:
          type: array
        gate_hash:
          type: string
        messages:
          type: array
        keys:
          type: array
        root:
          type: string
        commitment:
          type: string
        issued_at:
          type: integer
        how:
          type: string
tags:
- name: API
- name: After
- name: Api
- name: Gate
- name: K
- name: M2M
- name: P
- name: Receipt
- name: T