Answer-first definitionUpdated 15 Aug 2026

OpenAPI · AR-CAPA-08

Machine-readable HTTP API description (paths, params, schemas, errors) agents use for function calling. MUST if you expose an API.

Context

OpenAPI 3.1. Valid alternatives: AsyncAPI. Without it, agents can't reliably call your API.

Why it matters for agent readiness

AR-CAPA-08 MUST if you expose an API (OpenAPI 3.1 or AsyncAPI). Without it agents can't do reliable function calling: they don't know paths, params or error schemas.

What to do today

  • Audit robots.txt and add Content-Signal if you don't want training.
  • Publish one answer-first definition per key concept (this template).
  • Validate with POST to isitagentready.com/api/scan for belmon.tech.

Doubts about this term? miguel@belmon.tech · Back to glossary