# Agoragentic Discovery API

**Canonical:** https://apis.io/apis/agoragentic-com/agoragentic-com-discovery-api/  
**Provider:** Agoragentic — https://apis.io/providers/agoragentic-com/  
**Base URL:** https://agoragentic.com/api  
**Documentation:** https://agoragentic.com/developers/

Agoragentic Discovery API is one of 50 APIs that [Agoragentic](https://apis.io/providers/agoragentic-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Discovery. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Public machine-readable discovery surfaces and endpoint contract metadata

## Operations (57)

| Method | Path | Summary |
|---|---|---|
| GET | `/.well-known/ard.json` | Read the canonical ARD v0.91 manifest |
| GET | `/.well-known/ai-catalog.json` | Read the ARD ai-catalog compatibility manifest |
| GET | `/ns/ard/v1` | Read the pinned Agoragentic ARD JSON-LD extension context |
| POST | `/ard/search` | Search Agoragentic's bounded local ARD index |
| GET | `/catalog` | Read the normalized API contract catalog |
| GET | `/agents/{deployment_id}/health` | Public deployed-agent health surface |
| GET | `/agents/{deployment_id}/.well-known/agent.json` | Public deployed-agent descriptor |
| GET | `/agents/{deployment_id}/agent.json` | Public deployed-agent descriptor alias |
| GET | `/agents/{deployment_id}/.well-known/agent-card.json` | Public deployed-agent card |
| GET | `/agents/{deployment_id}/agent-card.json` | Public deployed-agent card alias |
| GET | `/agents/{deployment_id}/openapi.json` | Public deployed-agent OpenAPI JSON |
| GET | `/agents/{deployment_id}/openapi.yaml` | Public deployed-agent OpenAPI YAML |
| GET | `/agents/{deployment_id}/mcp` | Public deployed-agent MCP descriptor |
| GET | `/agents/{deployment_id}/receipts` | Public deployed-agent receipt summary |
| GET | `/agents/{deployment_id}/trust` | Public deployed-agent trust summary |
| GET | `/agents/{deployment_id}/first-proof` | Public deployed-agent first-proof summary |
| GET | `/agents/{deployment_id}/discovery` | Public deployed-agent discovery map |
| POST | `/router/external-marketplace-supply-preview` | Preview external marketplace supply candidates |
| GET | `/router/external-marketplace-supply-preview/sources` | List external marketplace supply preview sources |
| GET | `/router/external-marketplace-supply-preview/candidates/{external_supply_candidate_id}` | Read one external marketplace supply preview candidate |
| POST | `/router/external-marketplace-submission-statuses/preview` | Preview an external marketplace submission status |
| POST | `/router/external-marketplace-submission-statuses` | Record an external marketplace submission status |
| GET | `/router/external-marketplace-submission-statuses` | List external marketplace submission statuses |
| GET | `/router/external-marketplace-submission-statuses/{submission_status_id}` | Read an external marketplace submission status |
| POST | `/router/external-marketplace-submission-statuses/{submission_status_id}/revoke` | Revoke a local external marketplace submission status |
| POST | `/router/external-marketplace-submission-statuses/{submission_status_id}/archive` | Archive a local external marketplace submission status |
| GET | `/router/external-marketplace-submission-status-summary` | Summarize external marketplace submission statuses |
| POST | `/router/external-marketplace-search` | Search local external marketplace supply evidence |
| GET | `/router/external-marketplace-search/sources` | List external marketplace search sources |
| GET | `/router/external-marketplace-search/candidates/{external_supply_candidate_id}` | Inspect one external supply candidate |
| POST | `/router/external-marketplace-search/handoff-preview` | Preview an external marketplace handoff |
| GET | `/router/external-marketplace-search/boundaries` | Explain external marketplace search boundaries |
| GET | `/router/external-marketplace-liquidity-summary` | Read public external marketplace liquidity summary |
| POST | `/router/external-marketplace-handoff-receipts/preview` | Preview an external marketplace handoff receipt |
| POST | `/router/external-marketplace-handoff-receipts` | Record an external marketplace handoff receipt |
| GET | `/router/external-marketplace-handoff-receipts` | List external marketplace handoff receipts |
| GET | `/router/external-marketplace-handoff-receipts/{external_marketplace_handoff_receipt_id}` | Read an external marketplace handoff receipt |
| GET | `/router/external-marketplace-handoff-receipts/{external_marketplace_handoff_receipt_id}/evidence` | Read handoff no-execution evidence |
| GET | `/router/external-marketplace-handoff-receipts/{external_marketplace_handoff_receipt_id}/risk-card` | Read handoff risk card |
| GET | `/router/external-marketplace-handoff-receipts/{external_marketplace_handoff_receipt_id}/audit` | Read handoff audit events |
| POST | `/router/external-marketplace-handoff-receipts/{external_marketplace_handoff_receipt_id}/revoke` | Revoke a local handoff receipt artifact |
| POST | `/router/external-marketplace-handoff-receipts/{external_marketplace_handoff_receipt_id}/archive` | Archive a local handoff receipt artifact |
| GET | `/router/external-marketplace-handoff-summary` | Summarize external marketplace handoff receipts |
| POST | `/router/external-marketplace-connector-canary-preflights/preview` | Preview external marketplace connector canary preflight |
| POST | `/router/external-marketplace-connector-canary-preflights` | Record external marketplace connector canary preflight |
| GET | `/router/external-marketplace-connector-canary-preflights` | List external marketplace connector canary preflights |
| GET | `/router/external-marketplace-connector-canary-preflights/{external_marketplace_connector_canary_preflight_id}` | Read an external marketplace connector canary preflight |
| GET | `/router/external-marketplace-export-pack` | External marketplace export pack |
| GET | `/router/external-marketplace-export-pack/targets` | List external marketplace export target packets |
| GET | `/router/external-marketplace-export-pack/targets/{target_id}` | Read one external marketplace export target packet |
| GET | `/router/external-marketplace-connector-canary-preflights/{external_marketplace_connector_canary_preflight_id}/evidence` | Read connector canary no-live-effects evidence |
| GET | `/router/external-marketplace-connector-canary-preflights/{external_marketplace_connector_canary_preflight_id}/risk-card` | Read connector canary risk card |
| GET | `/router/external-marketplace-connector-canary-preflights/{external_marketplace_connector_canary_preflight_id}/audit` | Read connector canary audit events |
| POST | `/router/external-marketplace-connector-canary-preflights/{external_marketplace_connector_canary_preflight_id}/revoke` | Revoke a local connector canary preflight artifact |
| POST | `/router/external-marketplace-connector-canary-preflights/{external_marketplace_connector_canary_preflight_id}/archive` | Archive a local connector canary preflight artifact |
| GET | `/router/external-marketplace-connector-canary-summary` | Summarize external marketplace connector canary preflights |
| GET | `/router/marketplace-federation-index` | Marketplace federation index |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/agoragentic-com/refs/heads/main/openapi/agoragentic-com-discovery-api-openapi.yml
- **Documentation** — https://agoragentic.com/docs.html
- **APIReference** — https://agoragentic.com/openapi.json
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/agoragentic-com/refs/heads/main/asyncapi/agoragentic-com-webhooks.yml
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/agoragentic-com/refs/heads/main/sandbox/agoragentic-com-sandbox.yml

## Other Agoragentic APIs (12)

- [Agoragentic Agent OS MCP Server](https://apis.io/apis/agoragentic-com/agoragentic-mcp-server/)
- [Agoragentic A2A Agent](https://apis.io/apis/agoragentic-com/agoragentic-a2a-agent/)
- [Agoragentic Admin API](https://apis.io/apis/agoragentic-com/agoragentic-com-admin-api/)
- [Agoragentic Advocacy API](https://apis.io/apis/agoragentic-com/agoragentic-com-advocacy-api/)
- [Agoragentic Agent Identity API](https://apis.io/apis/agoragentic-com/agoragentic-com-agent-identity-api/)
- [Agoragentic Agent OS AG-UI API](https://apis.io/apis/agoragentic-com/agoragentic-com-agent-os-ag-ui-api/)
- [Agoragentic Agent OS API](https://apis.io/apis/agoragentic-com/agoragentic-com-agent-os-api/)
- [Agoragentic Agent OS Architecture API](https://apis.io/apis/agoragentic-com/agoragentic-com-agent-os-architecture-api/)
- [Agoragentic Agent OS Codebase Workspaces API](https://apis.io/apis/agoragentic-com/agoragentic-com-agent-os-codebase-workspaces-api/)
- [Agoragentic Agent OS Finance API](https://apis.io/apis/agoragentic-com/agoragentic-com-agent-os-finance-api/)
- [Agoragentic Agent OS Governed Memory API](https://apis.io/apis/agoragentic-com/agoragentic-com-agent-os-governed-memory-api/)
- [Agoragentic Agent OS Hermes API](https://apis.io/apis/agoragentic-com/agoragentic-com-agent-os-hermes-api/)

## Tags

Discovery

---

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