{"id":"ia.openapi-live","name":"Live OpenAPI verification","verify":{"command":"curl -sf https://{domain}/openapi.json | jq -r '.paths | keys[]'","rescan":"isagentready results {domain} --checkpoint ia.openapi-live","expect":"A list of paths. Call one documented GET path with curl to check it."},"fix":{"steps":[{"action":"Document at least one GET operation that needs no auth, for example a health or a search endpoint.","order":1,"language":null,"code_example":null},{"action":"Make sure that the response matches the documented status and schema.","order":2,"language":null,"code_example":null}],"summary":"Make sure that one safe GET operation in the OpenAPI document works as documented.","skill":{"name":"agent-protocols","anchor":"ia.openapi-live"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"OpenAPI Specification","kind":"spec","url":"https://spec.openapis.org/oas/latest.html"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-22","evidence_tier":"supported","evidence_source":{"title":"agentready.org AR-ACT-02","url":"https://www.agentready.org/#act"},"why":"A machine-readable API description is more useful when one demonstrably safe operation also behaves as documented.","profiles":["api_tool_readiness"],"score_role":"core","legacy_id":"4.19","i18n":{"nl":{"name":"Live OpenAPI-verificatie","steps":["Documenteer minimaal een GET-operatie zonder auth, bijvoorbeeld een health- of zoekendpoint.","Zorg dat de response overeenkomt met de gedocumenteerde status en het schema."],"why":"Een machineleesbare API-beschrijving is nuttiger als een aantoonbaar veilige operatie zich ook gedraagt zoals beschreven.","fix_summary":"Zorg dat een veilige GET-operatie in het OpenAPI-document werkt zoals beschreven.","verify_expect":"Een lijst met paden. Roep met curl één gedocumenteerd GET-pad aan om het te controleren."}},"ar_practice_ids":["AR-ACT-02"],"strength":"SHOULD","ar_mapping":"full","evidence_type":"measured_study","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.openapi-live","maturity":"recommended","applicability":{"mode":"detected_surface","condition":null,"surfaces":["api"]}}