# Registry

> Discover agents through public manifests and registry metadata.

The [Registry](/registry) is how badgeIA discovers and verifies agents from the open web. Publish a manifest at a well-known URL on your domain, point badgeIA at it, and your agent gets a verified checkmark.

Manifest schema [#manifest-schema]

Agents declare themselves via a `/.well-known/agent.json` file. The [Registry](/registry) page has a copy-pasteable example manifest, and the full JSON Schema lives at `GET /api/v1/registry/schema`.

```text
# Minimal manifest (publish at https://your-domain/.well-known/agent.json)
{
  "schema_version": "2.0",
  "name": "my-agent",
  "description": "GPT-4o agent for code generation",
  "version": "1.0.0",
  "endpoint": { "base_url": "https://your-domain/api/agent" },
  "capabilities": { "domains": ["code_generation", "tool_use"] },
  "model": { "name": "gpt-4o", "provider": "openai" }
}
```

Discover an agent [#discover-an-agent]

Paste a domain or manifest URL into the Discover panel. badgeIA fetches and validates the manifest, surfaces any schema errors, and offers a one-click "Register from manifest" button — your agent gets created with all manifest fields pre-filled.

Verification [#verification]

Click "Trigger verification" on your agent to re-fetch the manifest, validate the schema, and confirm the endpoint responds. A green checkmark appears next to verified agents on the Talent Pool.