replynodes-com

replynodes-com Watches API

The watches API from replynodes-com — 3 operation(s) for watches.

GitHub OpenAPI

Operations 5

POST /v1/watches Create a Company Changes Watch #
GET /v1/watches List Company Changes Watches #
GET /v1/watches/{id} Retrieve a Company Changes Watch #
PATCH /v1/watches/{id} Update a Company Changes Watch #
GET /v1/watches/{id}/events List events delivered to a Watch #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/replynodes-com/openapi/replynodes-com-watches-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/replynodes-com/json-schema/replynodes-com-brand-styleguide-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/replynodes-com/json-schema/replynodes-com-agent-status-schema.json
📊
JSONSchema
https://artifacts.apis.io/replynodes-com/json-schema/replynodes-com-web-context-brand-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/replynodes-com/json-schema/replynodes-com-brand-retrieve-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/replynodes-com/json-schema/replynodes-com-markdown-json-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/replynodes-com/json-schema/replynodes-com-monitor-update-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/replynodes-com:replynodes-com-watches-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

replynodes-com-watches-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: ReplyNodes Fetcher Watches API
  version: v1
  description: 'Read-only data APIs for AI agents. Bearer auth. Prepaid credits / free tier.


    Click **Authorize** and paste ONLY the API key (no "Bearer" prefix) — Swagger adds it automatically.'
servers:
- url: https://api.replynodes.com
security:
- bearerAuth: []
tags:
- name: watches
paths:
  /v1/watches:
    post:
      operationId: watchCreate
      tags:
      - watches
      summary: Create a Company Changes Watch
      description: Creates one non-archived Watch per organization and Entity. Duplicate creates return 409 watch_exists unless an exact Idempotency-Key replay is supplied. Existing retained history is reused and no baseline is fabricated. Topics default to the available deterministic families (pricing, integrations, customers); unavailable semantic topics are rejected with 422 topic_unavailable. Frequency defaults to 24h. Webhook secrets are AES-256-GCM encrypted at rest and never returned.
      security:
      - bearerAuth: []
      responses:
        '200':
          description: Idempotency-Key replay
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WatchEnvelope'
        '201':
          description: Watch created
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WatchEnvelope'
        '400':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      parameters:
      - name: Idempotency-Key
        in: header
        required: false
        description: Key for replaying an identical create.
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WatchCreateRequest'
    get:
      operationId: watchList
      tags:
      - watches
      summary: List Company Changes Watches
      description: Lists tenant-private Watches for the organization.
      security:
      - bearerAuth: []
      responses:
        '200':
          description: Success
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WatchPage'
        '400':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 20
      - name: cursor
        in: query
        required: false
        schema:
          type: string
      - name: status
        in: query
        required: false
        schema:
          type: string
      - name: target
        in: query
        required: false
        schema:
          type: string
  /v1/watches/{id}:
    parameters:
    - name: id
      in: path
      required: true
      schema:
        type: string
        format: uuid
    get:
      operationId: watchRetrieve
      tags:
      - watches
      summary: Retrieve a Company Changes Watch
      description: Returns a tenant-private Watch and shared Entity coverage.
      security:
      - bearerAuth: []
      responses:
        '200':
          description: Success
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WatchEnvelope'
        '401':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    patch:
      operationId: watchUpdate
      tags:
      - watches
      summary: Update a Company Changes Watch
      description: Updates topics, requested_frequency, status, or webhook; the Entity/domain is immutable. Topic intervals never delete history. Archived is terminal and idempotent only for archiving; other changes return watch_archived. There is no public DELETE.
      security:
      - bearerAuth: []
      responses:
        '200':
          description: Success
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WatchEnvelope'
        '400':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WatchUpdateRequest'
  /v1/watches/{id}/events:
    parameters:
    - name: id
      in: path
      required: true
      schema:
        type: string
        format: uuid
    get:
      operationId: watchEvents
      tags:
      - watches
      summary: List events delivered to a Watch
      description: Returns canonical Events whose topic interval covered the Watch at detected_at and which were detected while it existed. Older or never-enabled history is available through Entity routes.
      security:
      - bearerAuth: []
      responses:
        '200':
          description: Success
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CCIEventPage'
        '400':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Standard ReplyNodes error envelope
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 20
      - name: cursor
        in: query
        required: false
        schema:
          type: string
      - name: topic
        in: query
        required: false
        schema:
          type: string
      - name: type
        in: query
        required: false
        schema:
          type: string
      - name: since
        in: query
        required: false
        schema:
          type: string
        description: RFC3339 or a relative 24h/30d window
      - name: until
        in: query
        required: false
        schema:
          type: string
        description: RFC3339 or a relative 24h/30d window
components:
  schemas:
    ErrorResponse:
      type: object
      required:
      - error
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      additionalProperties: false
    CCIEventDetector:
      type: object
      properties:
        version:
          type: string
        extractor_version:
          type: string
        method:
          type: string
          enum:
          - deterministic
          - semantic
        model:
          type:
          - string
          - 'null'
        model_config_hash:
          type:
          - string
          - 'null'
        provider:
          type: string
        provider_version:
          type: string
        provider_commit:
          type: string
      required:
      - version
      - extractor_version
      - method
      - model
      - model_config_hash
      - provider
      - provider_version
      - provider_commit
      additionalProperties: false
    CCIEventPage:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/CCIEvent'
        meta:
          $ref: '#/components/schemas/CCIPageMeta'
      required:
      - data
      - meta
      additionalProperties: false
    CCIPageMeta:
      type: object
      properties:
        request_id:
          type: string
        next_cursor:
          type: string
        has_more:
          type: boolean
      required:
      - request_id
      - next_cursor
      - has_more
      additionalProperties: false
    WatchUpdateRequest:
      type: object
      properties:
        topics:
          type: array
          items:
            $ref: '#/components/schemas/WatchTopic'
        requested_frequency:
          $ref: '#/components/schemas/WatchFrequency'
        status:
          $ref: '#/components/schemas/WatchStatus'
        webhook:
          $ref: '#/components/schemas/WatchWebhook'
      required: []
      additionalProperties: false
    WatchEnvelope:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/Watch'
        meta:
          $ref: '#/components/schemas/CCIRequestMeta'
      required:
      - data
      - meta
      additionalProperties: false
    CCIEvidence:
      type: object
      properties:
        id:
          type: string
        page_id:
          type: string
        source_url:
          type: string
        before_observation_id:
          type:
          - string
          - 'null'
        after_observation_id:
          type:
          - string
          - 'null'
        before_snapshot_id:
          type:
          - string
          - 'null'
        after_snapshot_id:
          type:
          - string
          - 'null'
        before_content_hash:
          type:
          - string
          - 'null'
        after_content_hash:
          type: string
        before_observed_at:
          type:
          - string
          - 'null'
          format: date-time
        after_observed_at:
          type: string
          format: date-time
        before_excerpt:
          type: string
        after_excerpt:
          type: string
        extractor:
          type: string
        detector_version:
          type: string
        provider:
          type: string
        provider_version:
          type: string
        provider_commit:
          type: string
        method:
          type: string
        model:
          type:
          - string
          - 'null'
        model_config_hash:
          type:
          - string
          - 'null'
        fields:
          type: array
          items:
            type: string
        created_at:
          type: string
          format: date-time
      required:
      - id
      - page_id
      - source_url
      - before_observation_id
      - after_observation_id
      - before_snapshot_id
      - after_snapshot_id
      - before_content_hash
      - after_content_hash
      - before_observed_at
      - after_observed_at
      - before_excerpt
      - after_excerpt
      - extractor
      - detector_version
      - provider
      - provider_version
      - provider_commit
      - method
      - model
      - model_config_hash
      - fields
      - created_at
      additionalProperties: false
    WatchFrequency:
      type: string
      enum:
      - 24h
      - 6h
    CCIEventEntity:
      type: object
      properties:
        id:
          type: string
        domain:
          type: string
      required:
      - id
      - domain
      additionalProperties: false
    WatchCreateRequest:
      type: object
      properties:
        target:
          type: string
        topics:
          type: array
          items:
            $ref: '#/components/schemas/WatchTopic'
        requested_frequency:
          $ref: '#/components/schemas/WatchFrequency'
        webhook:
          $ref: '#/components/schemas/WatchWebhook'
      required:
      - target
      additionalProperties: false
    CCIStateRef:
      type: object
      properties:
        state_id:
          type:
          - string
          - 'null'
        state_version:
          type:
          - integer
          - 'null'
        snapshot_ids:
          type: array
          items:
            type: string
        observation_ids:
          type: array
          items:
            type: string
        content_hashes:
          type: array
          items:
            type: string
      required:
      - state_id
      - state_version
      - snapshot_ids
      - observation_ids
      - content_hashes
      additionalProperties: false
    CCIConfidence:
      type: object
      properties:
        score:
          type: number
        calibrated:
          type: boolean
        method:
          type: string
        model:
          type:
          - string
          - 'null'
      required:
      - score
      - calibrated
      - method
      additionalProperties: false
    WatchPage:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Watch'
        meta:
          $ref: '#/components/schemas/CCIPageMeta'
      required:
      - data
      - meta
      additionalProperties: false
    WatchStatus:
      type: string
      enum:
      - active
      - paused
      - archived
    WatchEntity:
      type: object
      properties:
        id:
          type: string
        domain:
          type: string
        display_name:
          type:
          - string
          - 'null'
        observed_since:
          type:
          - string
          - 'null'
          format: date-time
        last_observed_at:
          type:
          - string
          - 'null'
          format: date-time
      required:
      - id
      - domain
      - display_name
      - observed_since
      - last_observed_at
      additionalProperties: false
    WatchWebhookConfig:
      type: object
      properties:
        url:
          type: string
          format: uri
      required:
      - url
      additionalProperties: false
    WatchCoverage:
      type: object
      properties:
        state:
          type: string
          enum:
          - initializing
          - healthy
          - degraded
          - failed
        last_run_at:
          type:
          - string
          - 'null'
          format: date-time
      required:
      - state
      - last_run_at
      additionalProperties: false
    CCIEventData:
      type: object
      properties:
        plan:
          type: string
        old_price:
          $ref: '#/components/schemas/CCIMoney'
        new_price:
          $ref: '#/components/schemas/CCIMoney'
        price:
          $ref: '#/components/schemas/CCIMoney'
        billing_period:
          type: string
        name:
          type: string
        change_kind:
          type: string
        product:
          type: string
        surface:
          type: string
        category:
          type: string
        integration_name:
          type: string
        integration_domain:
          type: string
        action:
          type: string
        customer_name:
          type: string
        customer_domain:
          type: string
        case_study_url:
          type: string
        old_headline:
          type: string
        new_headline:
          type: string
        old_category:
          type: string
        new_category:
          type: string
        target_market_delta:
          type: string
        enterprise_messaging_added:
          type: boolean
      required: []
      additionalProperties: false
    CCIEventSource:
      type: object
      properties:
        page_ids:
          type: array
          items:
            type: string
        urls:
          type: array
          items:
            type: string
      required:
      - page_ids
      - urls
      additionalProperties: false
    WatchWebhook:
      type: object
      properties:
        url:
          type: string
          format: uri
        secret:
          type: string
          writeOnly: true
      required:
      - url
      - secret
      additionalProperties: false
    CCIRequestMeta:
      type: object
      properties:
        request_id:
          type: string
      required:
      - request_id
      additionalProperties: false
    ErrorDetail:
      type: object
      required:
      - code
      - message
      - request_id
      properties:
        code:
          type: string
        message:
          type: string
        request_id:
          type: string
      additionalProperties: false
    Watch:
      type: object
      properties:
        id:
          type: string
        target:
          type: string
        entity:
          $ref: '#/components/schemas/WatchEntity'
        topics:
          type: array
          items:
            $ref: '#/components/schemas/WatchTopic'
        unavailable_topics:
          type: array
          items:
            $ref: '#/components/schemas/WatchTopic'
          description: Currently active subscriptions whose event families are unavailable; their topic intervals and history remain retained.
        requested_frequency:
          $ref: '#/components/schemas/WatchFrequency'
        effective_frequency:
          $ref: '#/components/schemas/WatchFrequency'
        status:
          $ref: '#/components/schemas/WatchStatus'
        started_at:
          type: string
          format: date-time
        status_changed_at:
          type: string
          format: date-time
        archived_at:
          type:
          - string
          - 'null'
          format: date-time
        coverage:
          $ref: '#/components/schemas/WatchCoverage'
        topic_intervals:
          type: array
          items:
            $ref: '#/components/schemas/WatchTopicInterval'
        webhook:
          $ref: '#/components/schemas/WatchWebhookConfig'
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
      - id
      - target
      - entity
      - topics
      - unavailable_topics
      - requested_frequency
      - effective_frequency
      - status
      - started_at
      - status_changed_at
      - archived_at
      - coverage
      - topic_intervals
      - created_at
      - updated_at
      additionalProperties: false
    CCIEventLineage:
      type: object
      properties:
        supersedes_event_id:
          type:
          - string
          - 'null'
        retracted_event_id:
          type:
          - string
          - 'null'
        lineage_event_id:
          type:
          - string
          - 'null'
        correction_reason:
          type:
          - string
          - 'null'
      required:
      - supersedes_event_id
      - retracted_event_id
      - lineage_event_id
      - correction_reason
      additionalProperties: false
    WatchTopicInterval:
      type: object
      properties:
        topic:
          $ref: '#/components/schemas/WatchTopic'
        enabled_at:
          type: string
          format: date-time
        disabled_at:
          type:
          - string
          - 'null'
          format: date-time
      required:
      - topic
      - enabled_at
      - disabled_at
      additionalProperties: false
    CCIMoney:
      type: object
      properties:
        amount:
          type: number
        currency:
          type: string
        period:
          type: string
      required:
      - amount
      - currency
      - period
      additionalProperties: false
    WatchTopic:
      type: string
      enum:
      - pricing
      - product
      - integrations
      - customers
      - positioning
    CCIEvent:
      type: object
      properties:
        id:
          type: string
        schema_version:
          type: integer
        type:
          type: string
          enum:
          - pricing.price_changed
          - pricing.plan_added
          - pricing.plan_removed
          - product.launched
          - feature.launched
          - integration.added
          - integration.removed
          - customer.reference_added
          - case_study.added
          - positioning.changed
        topic:
          $ref: '#/components/schemas/WatchTopic'
        subject:
          type: string
        entity:
          $ref: '#/components/schemas/CCIEventEntity'
        summary:
          type: string
        status:
          type: string
          enum:
          - active
          - superseded
          - retracted
        detected_at:
          type: string
          format: date-time
        first_observed_at:
          type: string
          format: date-time
        previous_observed_at:
          type: string
          format: date-time
        current_observed_at:
          type: string
          format: date-time
        data:
          $ref: '#/components/schemas/CCIEventData'
        source:
          $ref: '#/components/schemas/CCIEventSource'
        before:
          $ref: '#/components/schemas/CCIStateRef'
        after:
          $ref: '#/components/schemas/CCIStateRef'
        detector:
          $ref: '#/components/schemas/CCIEventDetector'
        confidence:
          $ref: '#/components/schemas/CCIConfidence'
        lineage:
          $ref: '#/components/schemas/CCIEventLineage'
        evidence:
          type: array
          items:
            $ref: '#/components/schemas/CCIEvidence'
        created_at:
          type: string
          format: date-time
      required:
      - id
      - schema_version
      - type
      - topic
      - subject
      - entity
      - summary
      - status
      - detected_at
      - first_observed_at
      - previous_observed_at
      - current_observed_at
      - data
      - source
      - before
      - after
      - detector
      - confidence
      - lineage
      - evidence
      - created_at
      additionalProperties: false
  headers:
    X-Request-Id:
      description: Correlation identifier returned by the gateway and echoed in meta.request_id.
      schema:
        type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: rn_test_<64hex> or rn_live_<64hex>
      description: API key. Paste the raw key only (e.g. rn_test_...) — the "Bearer " prefix is added automatically.