CipherOwl · OpenAPI Overlay 1.0.0

API Evangelist enhancements for CipherOwl SRR API

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

What the actions change

x-apievangelist-ratingx-apievangelist-notesx-token-endpointx-grant-typex-token-ttl-secondsx-agent-guidance

Targets 3

$.info
$.servers
$.components.securitySchemes.BearerAuth

OpenAPI Overlay

Raw ↑ 
overlay: 1.0.0
info:
  title: API Evangelist enhancements for CipherOwl SRR API
  version: 1.0.0
extends: openapi/cipherowl-openapi.json
x-provenance:
  generated: '2026-07-18'
  method: generated
  source: openapi/cipherowl-openapi.json
actions:
- target: $.info
  update:
    x-apievangelist-rating: 4
    x-apievangelist-notes: >-
      Spec reconstructed from the per-endpoint OpenAPI blocks embedded in
      readme.cipherowl.ai (README-hosted docs); merged provider-wide by the
      enrichment pipeline. Auth is OAuth2 client-credentials -> Bearer JWT.
- target: $.servers
  update:
  - url: https://svc.cipherowl.ai
    description: Unified production host (v2.1.0). Legacy tools.prod.cipherowl.ai is
      deprecated.
  - url: https://svc.cipherowl.com
    description: Alternate production host.
- target: $.components.securitySchemes.BearerAuth
  update:
    x-token-endpoint: https://svc.cipherowl.ai/oauth/token
    x-grant-type: client_credentials
    x-token-ttl-seconds: 86400
- target: $.info
  update:
    x-agent-guidance: >-
      Use ?config=co-sandbox against the curated sandbox addresses to run the
      full screen -> score -> breakdown -> detail -> report funnel for free.
      Cache the OAuth token (expires_in), refresh on 401, back off on 429 honoring
      Retry-After. See conventions/cipherowl-conventions.yml.