openapi: 3.1.0
info:
  title: Dealboard API
  version: '2026-10-15'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-15: 8 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Dealboard has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 2
    documentation: 6
    pages-with-code: 1
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-15'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://getdealboard.com/developers/reference
  - https://getdealboard.com/developers
servers:
- url: https://app.getdealboard.com
paths:
  /v1/boards/{id}:
    get:
      operationId: get_v1_boards_id
      tags:
      - Boards
      summary: fetch one board
      x-source: https://getdealboard.com/developers/reference
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    patch:
      operationId: patch_v1_boards_id
      tags:
      - Boards
      summary: update a board
      x-source: https://getdealboard.com/developers/reference
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/deals/{id}/activity:
    get:
      operationId: get_v1_deals_id_activity
      tags:
      - Deals
      summary: full activity feed
      x-source: https://getdealboard.com/developers/reference
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/reports/weighted-pipeline:
    get:
      operationId: get_v1_reports_weighted_pipeline
      tags:
      - Reports
      summary: probability-weighted pipeline totals + per-stage breakdown
      x-source: https://getdealboard.com/developers/reference
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/templates/{id}/use:
    post:
      operationId: post_v1_templates_id_use
      tags:
      - Templates
      summary: Log a use when one is sent
      x-source: https://getdealboard.com/developers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/{v1id}:
    get:
      operationId: get_v1_v1id
      tags:
      - Api
      summary: list boards
      x-source: https://getdealboard.com/developers/reference
      parameters:
      - name: v1id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
        collapsed_from: 7 example path(s) differing only at v1Id
    post:
      operationId: post_v1_v1id
      tags:
      - Api
      summary: create a board
      x-source: https://getdealboard.com/developers/reference
      parameters:
      - name: v1id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
        collapsed_from: 5 example path(s) differing only at v1Id
  /v1/{v1id}/{id}:
    delete:
      operationId: delete_v1_v1id_id
      tags:
      - Api
      summary: soft-delete a deal
      x-source: https://getdealboard.com/developers/reference
      parameters:
      - name: v1id
        in: path
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
        collapsed_from: 3 example path(s) differing only at v1Id
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Boards
- name: Deals
- name: Reports
- name: Templates