jid-com Monitors API

openapi: 3.2.0
info:
  title: Jid Monitors API
  version: 1.3.0
  summary: The trust API for AI agents.
  description: 'Before an agent pays, signs, books, hires or buys, Jid checks the business it is dealing with: real, active, licensed for this activity, not sanctioned, with the receipts. Every fact is cited to the registry that issued it. Decisions apply the published rules (https://jid.com/decision-rules, version 2026-10-15.1) and are not legal advice. No key: 10 requests a minute and 100 a day per IP. A free key (no card) includes 1,000 checks a month. Business information only; not a consumer report and not for FCRA purposes.'
  termsOfService: https://jid.com/api-terms
  contact:
    name: Jid
    email: hello@jid.com
    url: https://jid.com
servers:
- url: https://jid.com
security:
- {}
- bearer: []
tags:
- name: Monitors
  description: Change monitoring with signed webhooks
paths:
  /v1/monitors:
    get:
      tags:
      - Monitors
      operationId: listMonitors
      summary: List your monitors
      security:
      - bearer: []
      responses:
        '200':
          description: Monitors
          content:
            application/json:
              schema:
                type: object
        '401':
          $ref: '#/components/responses/Error'
    post:
      tags:
      - Monitors
      operationId: createMonitor
      summary: Watch a file; each change is delivered with old and new values
      security:
      - bearer: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - entity_id
              properties:
                entity_id:
                  type: string
                webhook_url:
                  type: string
                  format: uri
                  pattern: ^https://
                email:
                  type: string
                  format: email
      responses:
        '201':
          description: Created. webhook_secret is returned once.
          content:
            application/json:
              schema:
                type: object
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '402':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
      callbacks:
        events:
          '{$request.body#/webhook_url}':
            post:
              summary: 'Change events. Headers: Jid-Signature: t=<unix>,v1=<hex HMAC-SHA256(secret, t + ''.'' + raw body)>; Jid-Delivery: <delivery_id>.'
              requestBody:
                content:
                  application/json:
                    schema:
                      $ref: '#/components/schemas/WebhookDelivery'
              responses:
                2XX:
                  description: Accepted. Anything else is retried on the next run with the same delivery_id.
    delete:
      tags:
      - Monitors
      operationId: deleteMonitor
      summary: Delete a monitor
      security:
      - bearer: []
      parameters:
      - name: id
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Deleted
        '404':
          $ref: '#/components/responses/Error'
components:
  responses:
    Error:
      description: Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
          required:
          - code
          - message
    WebhookDelivery:
      type: object
      properties:
        type:
          const: jid.monitor.events
        delivery_id:
          type: string
        monitor_id:
          type: string
        file:
          type: object
          properties:
            id:
              type: string
            name:
              type: string
            url:
              type: string
        events:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              occurred_at:
                type: string
              kind:
                type: string
              predicate:
                type:
                - string
                - 'null'
              old_value: {}
              new_value: {}
              source:
                type:
                - string
                - 'null'
              summary:
                type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: 'jid_live_... key from https://jid.com/pricing (free key: no card).'
externalDocs:
  description: API reference
  url: https://jid.com/api-docs