# Agent Disco API

**Canonical:** https://apis.io/apis/agentdisco-io/agent-disco-api/  
**Provider:** Agent Disco — https://apis.io/providers/agentdisco-io/  
**Base URL:** https://agentdisco.io/api/v1  
**Documentation:** https://agentdisco.io/api/docs

Agent Disco API is published by [Agent Disco](https://apis.io/providers/agentdisco-io/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include AI Agents, Agent Discoverability, Website Auditing, Webhook, and Scanning. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, authentication docs, and rate-limit docs.

Public HTTP API under /api/v1 - submit a URL for grading, poll the scan, diff it against the previous scan, read a host's latest grade and history, embed an SVG/PNG grade badge, read the check catalogue, mint and revoke API keys, register signed scan.completed webhooks, and unlist or re-list a host with DNS-TXT verification. Anonymous access is rate-limited per IP; ak_ bearer keys raise the quota and Colony agents can mint one non-interactively via RFC 8693 token exchange.

## Operations (25)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/openapi.json` | Fetch this OpenAPI document. |
| GET | `/api/v1/keys` | List the caller account's API keys. |
| POST | `/api/v1/keys` | Create an anonymous API key. |
| DELETE | `/api/v1/keys/{id}` | Revoke one of the caller account's API keys. |
| GET | `/api/v1/websites/{host}/badge.svg` | Embeddable SVG grade badge for a host. |
| GET | `/api/v1/websites/{host}/badge.png` | Embeddable PNG grade badge for a host. |
| GET | `/api/v1/checks` | List every active check. |
| GET | `/api/v1/auth/colony/agent` | Discover the parameters for the Colony agent sign-in exchange. |
| POST | `/api/v1/auth/colony/agent` | Sign in with a Colony agent identity for an AgentDisco API key. |
| GET | `/api/v1/ops/check-health` | Per-check rolling-window health counts. |
| GET | `/api/v1/ops/version` | What release is currently deployed. |
| POST | `/api/v1/scans` | Submit a new scan. |
| GET | `/api/v1/scans/{id}` | Fetch a scan by id. |
| GET | `/api/v1/scans/{id}/diff` | Diff a scan against the previous one. |
| POST | `/api/v1/websites/{host}/unlist` | Request an unlist verification token. |
| POST | `/api/v1/websites/{host}/unlist/confirm` | Confirm the unlist with the issued token. |
| POST | `/api/v1/websites/{host}/relist` | Request a re-list verification token. |
| POST | `/api/v1/websites/{host}/relist/confirm` | Confirm the re-list with the issued token. |
| GET | `/api/v1/webhooks` | List the caller account's webhooks. |
| POST | `/api/v1/webhooks` | Create a scan webhook. |
| DELETE | `/api/v1/webhooks/{id}` | Delete a webhook. |
| GET | `/api/v1/websites/{host}` | Summary for a scanned website. |
| DELETE | `/api/v1/websites/{host}` | Delete a website and all its scans. |
| GET | `/api/v1/websites/{host}/scans` | Scan history for a website. |
| POST | `/api/v1/websites/{host}/rescan` | Re-scan a known website. |

## Machine-readable artifacts (12)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/agentdisco-io/refs/heads/main/openapi/agentdisco-io-openapi.yml
- **OpenAPI** — https://agentdisco.io/api/v1/openapi.json
- **APIReference** — https://agentdisco.io/api/docs
- **Documentation** — https://agentdisco.io/developers
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/agentdisco-io/refs/heads/main/authentication/agentdisco-io-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/agentdisco-io/refs/heads/main/conventions/agentdisco-io-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/agentdisco-io/refs/heads/main/errors/agentdisco-io-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/agentdisco-io/refs/heads/main/data-model/agentdisco-io-data-model.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/agentdisco-io/refs/heads/main/overlays/agentdisco-io-openapi-overlay.yaml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/agentdisco-io/refs/heads/main/rate-limits/agentdisco-io-rate-limits.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/agentdisco-io/refs/heads/main/asyncapi/agentdisco-io-webhooks.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/agentdisco-io/refs/heads/main/apis.yml

## Tags

AI Agents, Agent Discoverability, Website Auditing, Webhook, Scanning

---

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