{"id":"ia.api-catalog","name":"API Catalog (RFC 9727)","verify":{"command":"curl -sf https://{domain}/.well-known/api-catalog | jq -e '.linkset | length > 0'","rescan":"isagentready results {domain} --checkpoint ia.api-catalog","expect":"exit code 0"},"fix":{"steps":[{"action":"Create a linkset with one entry per API and service-desc, service-doc and status links.","order":1,"language":"json","code_example":"{\n  \"linkset\": [{\n    \"anchor\": \"https://example.com/api/v1\",\n    \"service-desc\": [{\"href\": \"https://example.com/openapi.json\", \"type\": \"application/openapi+json\"}],\n    \"service-doc\": [{\"href\": \"https://example.com/docs\", \"type\": \"text/html\"}]\n  }]\n}"},{"action":"Serve it at /.well-known/api-catalog with Content-Type application/linkset+json.","order":2,"language":null,"code_example":null}],"summary":"Serve /.well-known/api-catalog as an application/linkset+json document.","skill":{"name":"agent-protocols","anchor":"ia.api-catalog"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"RFC 9727 API Catalog","kind":"spec","url":"https://datatracker.ietf.org/doc/rfc9727/"},{"title":"RFC 9264 Linkset","kind":"spec","url":"https://datatracker.ietf.org/doc/rfc9264/"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-22","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-READ-06","url":"https://www.agentready.org/#read"},"why":"An API Catalog (RFC 9727 with an RFC 9264 linkset) gives agents one discovery endpoint for all APIs of the site. It links to OpenAPI documents, human docs and health endpoints.","profiles":["api_tool_readiness"],"score_role":"bonus","legacy_id":"4.10","i18n":{"nl":{"name":"API Catalog (RFC 9727)","steps":["Maak een linkset met een entry per API en links voor service-desc, service-doc en status.","Lever het op /.well-known/api-catalog met Content-Type application/linkset+json."],"why":"Een API Catalog (RFC 9727 met een RFC 9264-linkset) geeft agents een discoverypunt voor alle API's van de site. Het linkt naar OpenAPI-documenten, docs en health-endpoints.","fix_summary":"Lever /.well-known/api-catalog als application/linkset+json-document.","verify_expect":"exitcode 0"}},"ar_practice_ids":["AR-READ-06","AR-ACT-02"],"strength":"SHOULD","ar_mapping":"full","evidence_type":"recommendation","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.api-catalog","maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api"]}}