cloro · OpenAPI Overlay 1.0.0

API Evangelist overlay for the cloro API

Enhancements layered over openapi/cloro-dev-openapi.yml by API Evangelist: tags per operation group (the source has none), the documented rate-limit and credit headers on monitor responses, the status page and changelog as external docs, and links to the sibling artifacts. The original contract is never mutated.

27 actions 27 updates documentation extends ../openapi/_original/cloro-dev-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for cloro's API. It is a proposal applied on top of the contract, not a document cloro publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

tagsheadersx-apievangelistexternalDocs

Targets 27 · first 16 shown; the file carries all of them

$.info
$
$.paths['/v1/monitor/chatgpt'].post
$.paths['/v1/monitor/gemini'].post
$.paths['/v1/monitor/grok'].post
$.paths['/v1/monitor/google'].post
$.paths['/v1/monitor/google/goto'].post
$.paths['/v1/monitor/google/news'].post
$.paths['/v1/monitor/copilot'].post
$.paths['/v1/monitor/perplexity'].post
$.paths['/v1/monitor/aimode'].post
$.paths['/v1/countries'].get
$.paths['/v1/async/task'].post
$.paths['/v1/async/task/batch'].post
$.paths['/v1/async/task/{taskId}'].get
$.paths['/v1/async/status'].get

OpenAPI Overlay

Raw ↑ 
overlay: 1.0.0
info:
  title: API Evangelist overlay for the cloro API
  version: '2026-10-07'
  description: 'Enhancements layered over openapi/cloro-dev-openapi.yml by API Evangelist: tags per operation group (the source has none), the documented rate-limit and credit headers on monitor responses, the status page and changelog as external docs, and links to the sibling artifacts. The original contract is never mutated.'
extends: ../openapi/_original/cloro-dev-openapi.yml
x-generated: '2026-10-07'
x-method: generated
actions:
- target: $.info
  update:
    x-apievangelist:
      profile: https://apis.io/providers/cloro-dev
      artifacts:
        conventions: conventions/cloro-dev-conventions.yml
        rate-limits: rate-limits/cloro-dev-rate-limits.yml
        errors: errors/cloro-dev-problem-types.yml
        webhooks: asyncapi/cloro-dev-webhooks.yml
        mcp: mcp/cloro-dev-mcp.yml
        lifecycle: lifecycle/cloro-dev-lifecycle.yml
- target: $
  update:
    externalDocs:
      description: cloro changelog
      url: https://cloro.dev/docs/changelog
    tags:
    - name: Monitor
      description: Synchronous AI-answer and search extraction endpoints under /v1/monitor
    - name: Async
      description: 'Background task queue: submit, batch, status, clear'
    - name: Utility
      description: Countries, states and credit balance
- target: $.paths['/v1/monitor/chatgpt'].post
  update:
    tags:
    - Monitor
- target: $.paths['/v1/monitor/gemini'].post
  update:
    tags:
    - Monitor
- target: $.paths['/v1/monitor/grok'].post
  update:
    tags:
    - Monitor
- target: $.paths['/v1/monitor/google'].post
  update:
    tags:
    - Monitor
- target: $.paths['/v1/monitor/google/goto'].post
  update:
    tags:
    - Monitor
- target: $.paths['/v1/monitor/google/news'].post
  update:
    tags:
    - Monitor
- target: $.paths['/v1/monitor/copilot'].post
  update:
    tags:
    - Monitor
- target: $.paths['/v1/monitor/perplexity'].post
  update:
    tags:
    - Monitor
- target: $.paths['/v1/monitor/aimode'].post
  update:
    tags:
    - Monitor
- target: $.paths['/v1/countries'].get
  update:
    tags:
    - Utility
- target: $.paths['/v1/async/task'].post
  update:
    tags:
    - Async
- target: $.paths['/v1/async/task/batch'].post
  update:
    tags:
    - Async
- target: $.paths['/v1/async/task/{taskId}'].get
  update:
    tags:
    - Async
- target: $.paths['/v1/async/status'].get
  update:
    tags:
    - Async
- target: $.paths['/v1/async/queue'].delete
  update:
    tags:
    - Async
- target: $.paths['/v1/credits'].get
  update:
    tags:
    - Utility
- target: $.paths['/v1/states'].get
  update:
    tags:
    - Utility
- target: $.paths['/v1/monitor/chatgpt'].post.responses['200']
  update:
    headers:
      X-RateLimit-Limit:
        description: Maximum requests per second allowed (1,000) - https://cloro.dev/docs/guides/concurrency
        schema:
          type: integer
      X-RateLimit-Remaining:
        description: Remaining requests available in this second
        schema:
          type: integer
      X-Concurrency-Limit:
        description: Total concurrent requests allowed by your plan
        schema:
          type: integer
      X-Concurrency-Current:
        description: Number of requests currently processing
        schema:
          type: integer
      X-Concurrency-Remaining:
        description: Available concurrent slots when request was received
        schema:
          type: integer
      X-Credits-Remaining:
        description: Credits remaining in your account
        schema:
          type: integer
      X-Credits-Charged:
        description: Credits charged for this request
        schema:
          type: integer
      X-Latency-Ms:
        description: Milliseconds the API spent on the request
        schema:
          type: integer
- target: $.paths['/v1/monitor/gemini'].post.responses['200']
  update:
    headers:
      X-RateLimit-Limit:
        description: Maximum requests per second allowed (1,000) - https://cloro.dev/docs/guides/concurrency
        schema:
          type: integer
      X-RateLimit-Remaining:
        description: Remaining requests available in this second
        schema:
          type: integer
      X-Concurrency-Limit:
        description: Total concurrent requests allowed by your plan
        schema:
          type: integer
      X-Concurrency-Current:
        description: Number of requests currently processing
        schema:
          type: integer
      X-Concurrency-Remaining:
        description: Available concurrent slots when request was received
        schema:
          type: integer
      X-Credits-Remaining:
        description: Credits remaining in your account
        schema:
          type: integer
      X-Credits-Charged:
        description: Credits charged for this request
        schema:
          type: integer
      X-Latency-Ms:
        description: Milliseconds the API spent on the request
        schema:
          type: integer
- target: $.paths['/v1/monitor/grok'].post.responses['200']
  update:
    headers:
      X-RateLimit-Limit:
        description: Maximum requests per second allowed (1,000) - https://cloro.dev/docs/guides/concurrency
        schema:
          type: integer
      X-RateLimit-Remaining:
        description: Remaining requests available in this second
        schema:
          type: integer
      X-Concurrency-Limit:
        description: Total concurrent requests allowed by your plan
        schema:
          type: integer
      X-Concurrency-Current:
        description: Number of requests currently processing
        schema:
          type: integer
      X-Concurrency-Remaining:
        description: Available concurrent slots when request was received
        schema:
          type: integer
      X-Credits-Remaining:
        description: Credits remaining in your account
        schema:
          type: integer
      X-Credits-Charged:
        description: Credits charged for this request
        schema:
          type: integer
      X-Latency-Ms:
        description: Milliseconds the API spent on the request
        schema:
          type: integer
- target: $.paths['/v1/monitor/google'].post.responses['200']
  update:
    headers:
      X-RateLimit-Limit:
        description: Maximum requests per second allowed (1,000) - https://cloro.dev/docs/guides/concurrency
        schema:
          type: integer
      X-RateLimit-Remaining:
        description: Remaining requests available in this second
        schema:
          type: integer
      X-Concurrency-Limit:
        description: Total concurrent requests allowed by your plan
        schema:
          type: integer
      X-Concurrency-Current:
        description: Number of requests currently processing
        schema:
          type: integer
      X-Concurrency-Remaining:
        description: Available concurrent slots when request was received
        schema:
          type: integer
      X-Credits-Remaining:
        description: Credits remaining in your account
        schema:
          type: integer
      X-Credits-Charged:
        description: Credits charged for this request
        schema:
          type: integer
      X-Latency-Ms:
        description: Milliseconds the API spent on the request
        schema:
          type: integer
- target: $.paths['/v1/monitor/google/news'].post.responses['200']
  update:
    headers:
      X-RateLimit-Limit:
        description: Maximum requests per second allowed (1,000) - https://cloro.dev/docs/guides/concurrency
        schema:
          type: integer
      X-RateLimit-Remaining:
        description: Remaining requests available in this second
        schema:
          type: integer
      X-Concurrency-Limit:
        description: Total concurrent requests allowed by your plan
        schema:
          type: integer
      X-Concurrency-Current:
        description: Number of requests currently processing
        schema:
          type: integer
      X-Concurrency-Remaining:
        description: Available concurrent slots when request was received
        schema:
          type: integer
      X-Credits-Remaining:
        description: Credits remaining in your account
        schema:
          type: integer
      X-Credits-Charged:
        description: Credits charged for this request
        schema:
          type: integer
      X-Latency-Ms:
        description: Milliseconds the API spent on the request
        schema:
          type: integer
- target: $.paths['/v1/monitor/copilot'].post.responses['200']
  update:
    headers:
      X-RateLimit-Limit:
        description: Maximum requests per second allowed (1,000) - https://cloro.dev/docs/guides/concurrency
        schema:
          type: integer
      X-RateLimit-Remaining:
        description: Remaining requests available in this second
        schema:
          type: integer
      X-Concurrency-Limit:
        description: Total concurrent requests allowed by your plan
        schema:
          type: integer
      X-Concurrency-Current:
        description: Number of requests currently processing
        schema:
          type: integer
      X-Concurrency-Remaining:
        description: Available concurrent slots when request was received
        schema:
          type: integer
      X-Credits-Remaining:
        description: Credits remaining in your account
        schema:
          type: integer
      X-Credits-Charged:
        description: Credits charged for this request
        schema:
          type: integer
      X-Latency-Ms:
        description: Milliseconds the API spent on the request
        schema:
          type: integer
- target: $.paths['/v1/monitor/perplexity'].post.responses['200']
  update:
    headers:
      X-RateLimit-Limit:
        description: Maximum requests per second allowed (1,000) - https://cloro.dev/docs/guides/concurrency
        schema:
          type: integer
      X-RateLimit-Remaining:
        description: Remaining requests available in this second
        schema:
          type: integer
      X-Concurrency-Limit:
        description: Total concurrent requests allowed by your plan
        schema:
          type: integer
      X-Concurrency-Current:
        description: Number of requests currently processing
        schema:
          type: integer
      X-Concurrency-Remaining:
        description: Available concurrent slots when request was received
        schema:
          type: integer
      X-Credits-Remaining:
        description: Credits remaining in your account
        schema:
          type: integer
      X-Credits-Charged:
        description: Credits charged for this request
        schema:
          type: integer
      X-Latency-Ms:
        description: Milliseconds the API spent on the request
        schema:
          type: integer
- target: $.paths['/v1/monitor/aimode'].post.responses['200']
  update:
    headers:
      X-RateLimit-Limit:
        description: Maximum requests per second allowed (1,000) - https://cloro.dev/docs/guides/concurrency
        schema:
          type: integer
      X-RateLimit-Remaining:
        description: Remaining requests available in this second
        schema:
          type: integer
      X-Concurrency-Limit:
        description: Total concurrent requests allowed by your plan
        schema:
          type: integer
      X-Concurrency-Current:
        description: Number of requests currently processing
        schema:
          type: integer
      X-Concurrency-Remaining:
        description: Available concurrent slots when request was received
        schema:
          type: integer
      X-Credits-Remaining:
        description: Credits remaining in your account
        schema:
          type: integer
      X-Credits-Charged:
        description: Credits charged for this request
        schema:
          type: integer
      X-Latency-Ms:
        description: Milliseconds the API spent on the request
        schema:
          type: integer