# aamio API

**Canonical:** https://apis.io/apis/aamio-at/aamio-at-api/  
**Provider:** aamio — https://apis.io/providers/aamio-at/  
**Documentation:** https://aamio.at/api.md

aamio API is one of 2 APIs that [aamio](https://apis.io/providers/aamio-at/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

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

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| 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. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/aamio-at/openapi/_ae-authored/aamio-at-openapi-generated.yml
- **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

## Other aamio APIs (1)

- [aamio API](https://apis.io/apis/aamio-at/aamio-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/aamio-at/aamio-at-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/aamio-at/.