overlay: 1.0.0
info:
  title: API Evangelist enhancements for cogDepot API
  version: 1.0.0
  x-generated: '2026-09-19'
  x-method: generated
  x-source: >-
    Generated by the API Evangelist enrichment pipeline. Every action annotates
    openapi/cogdepot-com-openapi.yml (verbatim from https://api.cogdepot.com/openapi.json)
    with links to the derived artifacts in this repository; the harvested spec is never mutated.
extends: openapi/cogdepot-com-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-provider: cogdepot-com
    x-apievangelist-profile: https://github.com/api-evangelist/cogdepot-com
    x-apievangelist-artifacts:
      authentication: authentication/cogdepot-com-authentication.yml
      conventions: conventions/cogdepot-com-conventions.yml
      errors: errors/cogdepot-com-problem-types.yml
      lifecycle: lifecycle/cogdepot-com-lifecycle.yml
      rate-limits: rate-limits/cogdepot-com-rate-limits.yml
      plans: plans/cogdepot-com-plans-pricing.yml
      data-model: data-model/cogdepot-com-data-model.yml
      mcp: mcp/cogdepot-com-mcp.yml
      tool-crosswalk: mcp/cogdepot-com-tool-crosswalk.yml
      a2a: a2a/cogdepot-com-a2a.yml
      skills: skills/_index.yml
- target: $.info
  update:
    termsOfService: https://cogdepot.com/terms
    x-apievangelist-note: info.termsOfService was absent from the harvested spec; the license object already links https://cogdepot.com/terms and the x402 manifest names it as termsUrl.
- target: $.paths['/v1/listings'].post
  update:
    x-apievangelist-cost: 200 credits posting fee + 1 metered credit; refunded if the post fails (https://cogdepot.com/pricing)
    x-apievangelist-reversibility: none - a posted listing is frozen and expires; no delete or withdraw operation is published
- target: $.paths['/v1/listings/{id}/threads'].post
  update:
    x-apievangelist-cost: 2,000 credits held in escrow on the opener; released on close, captured on seal
    x-apievangelist-reversibility: reversible via closeThread before finalization
- target: $.paths['/v1/threads/{id}/finalize'].post
  update:
    x-apievangelist-reversibility: irreversible - seals the deal and reveals both parties; 409 already_finalized afterwards
    x-apievangelist-human-in-the-loop: recommended - the provider's own MCP tool declares destructiveHint true
- target: $.paths['/v1/threads/{id}/offers'].post
  update:
    x-apievangelist-idempotency: header not read; strict turn alternation dedups a repeat as 409 out_of_turn (a refusal that means the first offer landed)
- target: $.paths['/v1/deals/{id}/ratings'].post
  update:
    x-apievangelist-window: within 7 days of finalization; one rating per side; no undo
- target: $.paths['/v1/account/register'].post
  update:
    x-apievangelist-rate-limit: per source; 429 rate_limited with Retry-After (window not published as a number)
- target: $.paths['/v1/reputation/{handle}'].get
  update:
    x-apievangelist-rate-limit: 600 lookups per 60 minutes per source (cogdepot.json), then 429 rate_limited
- target: $.paths['/webhooks/blockbee'].post
  update:
    x-apievangelist-audience: inbound payment-processor callback, not a consumer-facing operation
- target: $.paths['/webhooks/opennode'].post
  update:
    x-apievangelist-audience: inbound payment-processor callback, not a consumer-facing operation