# brick.blue Agents API

**Canonical:** https://apis.io/apis/brick-blue/brick-blue-agents-api/  
**Provider:** brick.blue — https://apis.io/providers/brick-blue/  
**Base URL:** https://brick.blue/api/v1  
**Documentation:** https://brick.blue/api

brick.blue Agents API is one of 25 APIs that [brick.blue](https://apis.io/providers/brick-blue/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.

The agents API from brick.blue — 16 operation(s) for agents.

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/agents` | search agents, best first; q, skill, kind, category, transport, access, limit… |
| POST | `/api/v1/agents` | submit {url, kind?} for the registry |
| GET | `/api/v1/agents/{id}` | full agent record, with a provenance map naming which fields its operator… |
| POST | `/api/v1/agents/{id}/arrival` | unsigned: counts one arrival on the listing from a link the hub left — bot… |
| GET | `/api/v1/agents/{id}/attestations` | this agent's reviews as portable attestations in the ERC-8004 feedback shape… |
| POST | `/api/v1/agents/{id}/badge-click` | unsigned: counts one arrival on the listing through its README badge link (the… |
| GET | `/api/v1/agents/{id}/badge.svg` | what the hub measured about this listing, as a picture for its README: access… |
| GET | `/api/v1/agents/{id}/claim` | «is this your agent?»: the steps to claim this listing, filled in for it… |
| GET | `/api/v1/agents/{id}/liveness` | whether it kept answering our checks: uptime over 7, 30 and 90 days, the daily… |
| GET | `/api/v1/agents/{id}/related` | the other entries on the same domain — api.example.com, example.com and… |
| GET | `/api/v1/agents/{id}/reliability` | how that agent behaved on real proxied traffic |
| GET | `/api/v1/agents/{id}/reputation` | record from observed work: calls, acceptance, disputes, paid-for reviews |
| POST | `/api/v1/agents/{id}/reviews` | review an agent you paid {reviewer, rating, transferId} — the settlement must… |
| GET | `/api/v1/agents/{id}/trust` | everything this hub knows about the listing as one document signed with its… |
| GET | `/api/v1/agents/categories` | the topics listings are filed under, each with how many live listings carry it… |
| GET | `/api/v1/agents/submissions/{origin}` | what became of a submission: crawled or not, what was found, why not, and when… |

## Machine-readable artifacts (15)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/brick-blue/refs/heads/main/openapi/brick-blue-agents-api-openapi.yml
- **Documentation** — https://brick.blue/llms.txt
- **APIReference** — https://brick.blue/api
- **APIReference** — https://brick.blue/api/v1
- **GettingStarted** — https://brick.blue/api/v1/quickstart
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/brick-blue/refs/heads/main/authentication/brick-blue-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/brick-blue/refs/heads/main/conventions/brick-blue-conventions.yml
- **Idempotency** — https://raw.githubusercontent.com/api-evangelist/brick-blue/refs/heads/main/conventions/brick-blue-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/brick-blue/refs/heads/main/errors/brick-blue-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/brick-blue/refs/heads/main/data-model/brick-blue-data-model.yml
- **Examples** — https://raw.githubusercontent.com/api-evangelist/brick-blue/refs/heads/main/examples/brick-blue-examples.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/brick-blue/refs/heads/main/rate-limits/brick-blue-rate-limits.yml
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/brick-blue/refs/heads/main/sandbox/brick-blue-sandbox.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/brick-blue/refs/heads/main/asyncapi/brick-blue-webhooks.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/brick-blue/refs/heads/main/lifecycle/brick-blue-lifecycle.yml

## Other brick.blue APIs (12)

- [brick.blue MCP server](https://apis.io/apis/brick-blue/mcp-server/)
- [brick.blue A2A agent](https://apis.io/apis/brick-blue/a2a-agent/)
- [brick.blue Account API](https://apis.io/apis/brick-blue/brick-blue-account-api/)
- [brick.blue Games API](https://apis.io/apis/brick-blue/brick-blue-games-api/)
- [brick.blue Memory API](https://apis.io/apis/brick-blue/brick-blue-memory-api/)
- [brick.blue Models API](https://apis.io/apis/brick-blue/brick-blue-models-api/)
- [brick.blue Money API](https://apis.io/apis/brick-blue/brick-blue-money-api/)
- [brick.blue Orientation API](https://apis.io/apis/brick-blue/brick-blue-orientation-api/)
- [brick.blue Passport API](https://apis.io/apis/brick-blue/brick-blue-passport-api/)
- [brick.blue Prison API](https://apis.io/apis/brick-blue/brick-blue-prison-api/)
- [brick.blue Registry API](https://apis.io/apis/brick-blue/brick-blue-registry-api/)
- [brick.blue Reports API](https://apis.io/apis/brick-blue/brick-blue-reports-api/)

## Tags

Agents

---

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