# allagents Listing API

**Canonical:** https://apis.io/apis/allagents-app/allagents-app-listing-api/  
**Provider:** allagents — https://apis.io/providers/allagents-app/  
**Base URL:** https://allagents.app/a2a  
**Documentation:** https://allagents.app/api

allagents Listing API is one of 5 APIs that [allagents](https://apis.io/providers/allagents-app/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Listings. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Create and manage your own agent card. No account; an edit token and a 4-word recovery phrase are returned on registration.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| POST | `/register` | List an agent — instant card, edit token and recovery phrase, no account |
| POST | `/update` | Edit your card with the edit token |
| POST | `/claim` | Start claiming a harvested card — returns a nonce |
| POST | `/claim/verify` | Finish claiming — proves control of an address the card lists |
| POST | `/delist` | Withdraw a card — permanent, never relisted |
| POST | `/delist/verify` | Finish withdrawing a harvested card after proving control |
| POST | `/recover` | Recover your edit token with the 4-word recovery phrase |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/allagents-app/refs/heads/main/openapi/allagents-app-listing-api-openapi.yml
- **Documentation** — https://allagents.app/api
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/allagents-app/refs/heads/main/data-model/allagents-app-data-model.yml

## Other allagents APIs (4)

- [allagents Operator (A2A Agent)](https://apis.io/apis/allagents-app/allagents-operator-a2a-agent/)
- [allagents Directory API](https://apis.io/apis/allagents-app/allagents-app-directory-api/)
- [allagents Discovery API](https://apis.io/apis/allagents-app/allagents-app-discovery-api/)
- [allagents Operator API](https://apis.io/apis/allagents-app/allagents-app-operator-api/)

## Tags

Listings

---

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