SlashAgents

Complementary by design

SlashAgents does not replace OpenAPI or docs pages. It complements them. /openapi.json is the schema. /agents is the runtime guide.

curl https://api.example.com/openapi.json   # schema (auto-generated)
curl https://api.example.com/docs           # human docs UI
curl https://api.example.com/agents         # plain-text runtime guide

Context is a feature

The guide can include free-form context: workload assumptions, compliance boundaries, operational caveats, and edge-case advice. This is intentionally flexible.

Suggested sections

Context, Auth, Limits, Retries, Idempotency, Pagination, Errors, Specs, Runtime. These are suggestions, not required fields.

Optional JSON

Teams may also publish /agents.json for strict parsing, but the canonical endpoint in this convention is plain-text /agents.