crob.at · OpenAPI Overlay 1.0.0

API Evangelist enhancements for the crob.at REST API

6 actions 6 updates update extends crob-at-openapi.json
Generated by API Evangelist Written by API Evangelist tooling for crob.at's API. It is a proposal applied on top of the contract, not a document crob.at publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-rate-limitx-idempotencyx-artifacts

Targets 4

$.info
$.paths['/api/random-team/{format}/save'].post
$.paths['/api/team'].post
$.paths['/api/feedback'].post

OpenAPI Overlay

Raw ↑ 
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