overlay: 1.0.0
info:
title: API Evangelist enhancements for the crob.at REST API
version: 1.0.0
x-generated: '2026-09-03'
x-method: generated
x-source: openapi/crob-at-openapi.json
extends: crob-at-openapi.json
actions:
- target: $.info
description: Link the catalog artifacts that document runtime semantics the spec does not carry.
update:
x-artifacts:
conventions: ../conventions/crob-at-conventions.yml
errors: ../errors/crob-at-problem-types.yml
rateLimits: ../rate-limits/crob-at-rate-limits.yml
authentication: ../authentication/crob-at-authentication.yml
agenticAccess: ../agentic-access/crob-at-agentic-access.yml
- target: $.paths['/api/random-team/{format}/save'].post
description: Surface the idempotency mechanism as a machine-readable flag.
update:
x-idempotency:
supported: true
mechanism: idempotencyKey request-body field
- target: $.paths['/api/team'].post
description: Flag the absence of replay protection on team creation.
update:
x-idempotency:
supported: false
note: A retried request can create a duplicate team page.
- target: $.paths['/api/team'].post
update:
x-rate-limit: 500 requests per hour per client
- target: $.paths['/api/random-team/{format}/save'].post
update:
x-rate-limit: 30 requests per hour per client
- target: $.paths['/api/feedback'].post
update:
x-rate-limit: 5 requests per hour per client
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.