# Discovery API

The Discovery operations of the BuildBase HTTP API: method, path, sign-in, request fields, answers and errors for each.

6 operations, 3 fully described. For how this part of BuildBase works, start with the [guide](/agents/agent-ready).

| Method | Path                                                                                                                                | What it does                                              |
| ------ | ----------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| GET    | [`/.well-known/api-catalog`](/http-api/reference/discovery/discovery-api-catalog-get)                                               | Get the API catalog that lists this server's HTTP APIs    |
| GET    | [`/.well-known/oauth-authorization-server/org/{orgId}`](/http-api/reference/discovery/discovery-oauth-authorization-server-org-get) | Get an organization's OAuth authorization server metadata |
| GET    | [`/api/v1/openapi.json`](/http-api/reference/discovery/discovery-openapi-public-get)                                                | Get the OpenAPI document for the public API               |
| GET    | [`/api/v1/openapi/org-api.json`](/http-api/reference/discovery/discovery-openapi-org-get)                                           | Get the OpenAPI document for the organization API         |
| GET    | [`/org/{orgId}`](/http-api/reference/discovery/discovery-get)                                                                       | Get an organization's issuer landing document             |
| GET    | [`/org/{orgId}/auth.md`](/http-api/reference/discovery/discovery-auth-md-list)                                                      | Get an organization's auth.md instructions for agents     |

## Related

- [API reference](/http-api/reference): every tag
- [Discovery guide](/agents/agent-ready)
