{"id":"ia.link-headers","name":"Link response headers","verify":{"command":"curl -sI https://{domain}/","rescan":"isagentready results {domain} --checkpoint ia.link-headers","expect":"A Link header with rel api-catalog, service-desc or service-doc"},"fix":{"steps":[{"action":"Add a Link header to the home page response that points to your API description.","order":1,"language":"text","code_example":"Link: </.well-known/api-catalog>; rel=\"api-catalog\", </openapi.json>; rel=\"service-desc\""},{"action":"Make sure that each linked resource returns HTTP 200.","order":2,"language":null,"code_example":null}],"summary":"Advertise your API catalog, service description or documentation with an RFC 8288 Link header.","skill":{"name":"ai-content-discovery","anchor":"ia.link-headers"}},"category":"discovery","aggregate":null,"references":[{"title":"RFC 8288 - Web Linking","kind":"spec","url":"https://www.rfc-editor.org/rfc/rfc8288"},{"title":"IANA Link Relations registry","kind":"guide","url":"https://www.iana.org/assignments/link-relations/link-relations.xhtml"},{"title":"RFC 9727 - API Catalog (`api-catalog` link relation)","kind":"spec","url":"https://datatracker.ietf.org/doc/rfc9727/"},{"title":"RFC 9264 - Linkset media types","kind":"spec","url":"https://www.rfc-editor.org/rfc/rfc9264"},{"title":"OpenAPI Specification","kind":"spec","url":"https://spec.openapis.org/oas/latest.html"}],"stage":"find","lifecycle":{"introduced":"2026-08-24","revised":["2026-09-02"],"retired":null,"replaced_by":null},"methodology_version":"2026-10-22","evidence_tier":"emerging","evidence_source":{"title":"agentready.org AR-FIND-04","url":"https://www.agentready.org/#reachable"},"why":"RFC 8288 Link headers let an established API advertise concrete machine-readable descriptions and documentation. This checkpoint never creates its own API applicability.","profiles":["ai_search_visibility","api_tool_readiness"],"score_role":"bonus","legacy_id":"1.9","i18n":{"nl":{"name":"Link-responseheaders","steps":["Voeg aan de response van de homepage een Link-header toe die naar je API-beschrijving verwijst.","Zorg dat elke gelinkte resource HTTP 200 geeft."],"why":"RFC 8288 Link-headers laten een bestaande API naar machineleesbare beschrijvingen en documentatie verwijzen. Dit checkpoint maakt zelf geen API-toepasbaarheid.","fix_summary":"Verwijs met een RFC 8288 Link-header naar je API-catalogus, servicebeschrijving of documentatie.","verify_expect":"Een Link-header met rel api-catalog, service-desc of service-doc"}},"ar_practice_ids":["AR-FIND-04","AR-READ-06"],"strength":"MAY","ar_mapping":"partial","evidence_type":"recommendation","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.link-headers","maturity":"emerging","applicability":{"mode":"always","condition":null,"surfaces":["website"]}}