Dapta API

openapi: 3.1.0
info:
  title: Dapta API
  version: '2026-10-25'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-25: 35 operation(s) read from 20 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; Dapta has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 34
    pages-with-code: 2
    pages-read: 20
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-25'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.dapta.ai/dapta-mcp/tools-reference.md
  - https://docs.dapta.ai/dforms/account/preferences.md
  - https://docs.dapta.ai/dforms/connect/webhooks/payload-reference.md
  - https://docs.dapta.ai/dcal/integrations/webhooks/payload-reference.md
  - https://docs.dapta.ai/dcal/developers.md
  - https://docs.dapta.ai/dforms/developers.md
  - https://docs.dapta.ai/dforms/connect/webhooks.md
  - https://docs.dapta.ai/dcal/developers/api-keys.md
  - https://docs.dapta.ai/dcal/developers/rest-api.md
  - https://docs.dapta.ai/dcal/developers/mcp-tools.md
  - https://docs.dapta.ai/dcal/integrations/webhooks.md
  - https://docs.dapta.ai/dforms/design/client-logos.md
  - https://docs.dapta.ai/dforms/developers/api-keys.md
  - https://docs.dapta.ai/integrations/webhook-set-up.md
  - https://docs.dapta.ai/dforms/developers/public-api.md
  - https://docs.dapta.ai/product-guides/create-an-api.md
  - https://docs.dapta.ai/dcal/getting-started/quickstart.md
  - https://docs.dapta.ai/dcal/bookings/confirm-or-decline.md
  - https://docs.dapta.ai/dapta-mcp/setup/mint-your-api-key.md
  - https://docs.dapta.ai/dcal/developers/cal-com-compatible-api.md
servers:
- url: https://api.dcal.ai
paths:
  /dapta-mcp/setup/mint-your-api-key.md:
    get:
      operationId: get_dapta_mcp_setup_mint_your_api_key_md
      tags:
      - Dapta Mcp
      summary: Mint your API key
      description: Perform an HTTP GET request on the URL with the `ask` and `goal` query parameters to retrieve an answer from the documentation.
      x-source: https://docs.dapta.ai/dapta-mcp/setup/mint-your-api-key.md
      parameters:
      - name: ask
        in: query
        required: false
        schema:
          type: string
        description: The immediate question, specific and self‑contained, written in natural language.
      - name: goal
        in: query
        required: false
        schema:
          type: string
        description: The user’s ultimate goal, describing the outcome they want to achieve.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /dapta-mcp/tools-reference.md:
    get:
      operationId: get_dapta_mcp_tools_reference_md
      tags:
      - Dapta Mcp
      summary: Tools Reference
      description: Perform an HTTP GET request on the URL with the `ask` and `goal` query parameters to retrieve a direct answer and relevant
        excerpts from the documentation.
      x-source: https://docs.dapta.ai/dapta-mcp/tools-reference.md
      parameters:
      - name: ask
        in: query
        required: false
        schema:
          type: string
        description: The immediate question, specific and self‑contained, written in natural language.
      - name: goal
        in: query
        required: false
        schema:
          type: string
        description: The user’s ultimate goal, describing the outcome they want to achieve.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /dcal/bookings/confirm-or-decline.md:
    get:
      operationId: get_dcal_bookings_confirm_or_decline_md
      tags:
      - Dcal
      summary: Confirm or decline requests
      x-source: https://docs.dapta.ai/dcal/bookings/confirm-or-decline.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetDcalBookingsConfirmOrDeclineMdResponse'
      x-evidence:
        kind: documentation
  /dcal/developers.md:
    get:
      operationId: get_dcal_developers_md
      tags:
      - Dcal
      summary: Developers
      description: Perform an HTTP GET request on the URL to retrieve the Markdown version of the developers documentation page, optionally providing
        `ask` and `goal` query parameters for contextual answers.
      x-source: https://docs.dapta.ai/dcal/developers.md
      parameters:
      - name: ask
        in: query
        required: false
        schema:
          type: string
        description: The immediate question, specific and self‑contained, written in natural language.
      - name: goal
        in: query
        required: false
        schema:
          type: string
        description: The user’s overall goal, describing the outcome they want to achieve.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /dcal/developers/api-keys.md:
    get:
      operationId: get_dcal_developers_api_keys_md
      tags:
      - Dcal
      summary: API keys
      x-source: https://docs.dapta.ai/dcal/developers/api-keys.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /dcal/getting-started/quickstart.md:
    get:
      operationId: get_dcal_getting_started_quickstart_md
      tags:
      - Dcal
      summary: 'Quickstart: your first booking link in 5 minutes'
      description: Retrieves the Quickstart guide page content.
      x-source: https://docs.dapta.ai/dcal/getting-started/quickstart.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /dcal/integrations/webhooks.md:
    get:
      operationId: get_dcal_integrations_webhooks_md
      tags:
      - Dcal
      summary: Webhooks
      description: Perform an HTTP GET request on the URL with the `ask` and `goal` query parameters to retrieve a direct answer and relevant
        excerpts from the documentation.
      x-source: https://docs.dapta.ai/dcal/integrations/webhooks.md
      parameters:
      - name: ask
        in: query
        required: false
        schema:
          type: string
        description: The immediate question; specific, self‑contained, natural language.
      - name: goal
        in: query
        required: false
        schema:
          type: string
        description: The user’s ultimate goal; describes the outcome they want.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /dforms/account/preferences.md:
    get:
      operationId: get_dforms_account_preferences_md
      tags:
      - Dforms
      summary: Preferences (language)
      x-source: https://docs.dapta.ai/dforms/account/preferences.md
      parameters:
      - name: ask
        in: query
        required: false
        schema:
          type: string
        description: The immediate question, specific and self‑contained.
      - name: goal
        in: query
        required: false
        schema:
          type: string
        description: The user’s ultimate goal, describing the desired outcome.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /dforms/connect/webhooks.md:
    get:
      operationId: get_dforms_connect_webhooks_md
      tags:
      - Dforms
      summary: Webhooks
      x-source: https://docs.dapta.ai/dforms/connect/webhooks.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /dforms/design/client-logos.md:
    get:
      operationId: get_dforms_design_client_logos_md
      tags:
      - Dforms
      summary: Client logos marquee
      x-source: https://docs.dapta.ai/dforms/design/client-logos.md
      parameters:
      - name: ask
        in: query
        required: false
        schema:
          type: string
        description: The immediate question, specific and self‑contained, written in natural language.
      - name: goal
        in: query
        required: false
        schema:
          type: string
        description: The user’s ultimate goal, describing the outcome they want to achieve.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetDformsDesignClientLogosMdResponse'
      x-evidence:
        kind: documentation
  /dforms/developers.md:
    get:
      operationId: get_dforms_developers_md
      tags:
      - Dforms
      summary: Developers
      description: Perform an HTTP GET request on the URL with the `ask` and `goal` query parameters to retrieve a direct answer and relevant
        excerpts from the documentation.
      x-source: https://docs.dapta.ai/dforms/developers.md
      parameters:
      - name: ask
        in: query
        required: false
        schema:
          type: string
        description: The immediate question, specific and self‑contained.
      - name: goal
        in: query
        required: false
        schema:
          type: string
        description: The user’s overall goal, describing the desired outcome.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /health:
    get:
      operationId: get_health
      tags:
      - Health
      summary: Check that the API is up.
      x-source: https://docs.dapta.ai/dcal/developers/rest-api.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /integrations/webhook-set-up.md:
    get:
      operationId: get_integrations_webhook_set_up_md
      tags:
      - Integrations
      summary: Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters
      x-source: https://docs.dapta.ai/integrations/webhook-set-up.md
      parameters:
      - name: ask
        in: query
        required: true
        schema:
          type: string
        description: The immediate question; specific, self‑contained, natural language query about the documentation page.
      - name: goal
        in: query
        required: true
        schema:
          type: string
        description: The broader goal the user wants to achieve, providing context for a more relevant answer.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /product-guides/create-an-api.md:
    get:
      operationId: get_product_guides_create_an_api_md
      tags:
      - Product Guides
      summary: Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters
      description: The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
      x-source: https://docs.dapta.ai/product-guides/create-an-api.md
      parameters:
      - name: ask
        in: query
        required: false
        schema:
          type: string
        description: 'The immediate question: it should be specific, self-contained, and written in natural language.'
      - name: goal
        in: query
        required: false
        schema:
          type: string
        description: The user’s ultimate goal, describing the outcome they want rather than restating the question.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/machine/availability:
    get:
      operationId: get_v1_machine_availability
      tags:
      - Machine
      summary: Check free times
      x-source: https://docs.dapta.ai/dcal/developers/api-keys.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/machine/bookings:
    get:
      operationId: get_v1_machine_bookings
      tags:
      - Machine
      summary: Read bookings
      x-source: https://docs.dapta.ai/dcal/developers/api-keys.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_v1_machine_bookings
      tags:
      - Machine
      summary: Create, hold, reschedule, confirm and decline bookings
      x-source: https://docs.dapta.ai/dcal/developers/api-keys.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/machine/bookings/{uid}:
    patch:
      operationId: patch_v1_machine_bookings_uid
      tags:
      - Machine
      summary: Create, hold, reschedule, confirm and decline bookings
      x-source: https://docs.dapta.ai/dcal/developers/api-keys.md
      parameters:
      - name: uid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/machine/bookings/{uid}/attendees:
    post:
      operationId: post_v1_machine_bookings_uid_attendees
      tags:
      - Machine
      summary: Create, hold, reschedule, confirm and decline bookings
      x-source: https://docs.dapta.ai/dcal/developers/api-keys.md
      parameters:
      - name: uid
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/machine/bookings/{uid}/cancel:
    post:
      operationId: post_v1_machine_bookings_uid_cancel
      tags:
      - Machine
      summary: Cancel bookings
      x-source: https://docs.dapta.ai/dcal/developers/api-keys.md
      parameters:
      - name: uid
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/public/forms/{accountcode}/{slug}:
    get:
      operationId: get_v1_public_forms_accountcode_slug
      tags:
      - Public
      summary: 'The published configuration of a form: its name and its steps, exactly as the public page renders them.'
      x-source: https://docs.dapta.ai/dforms/developers/public-api.md
      parameters:
      - name: accountcode
        in: path
        required: true
        schema:
          type: string
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1PublicFormsAccountcodeSlugResponse'
      x-evidence:
        kind: documentation
  /v1/public/forms/{accountcode}/{slug}/booking:
    post:
      operationId: post_v1_public_forms_accountcode_slug_booking
      tags:
      - Public
      summary: Record that a respondent booked a meeting, from a Scheduler step or an outcome's scheduling embed, so the booking is tied to the
        same session.
      x-source: https://docs.dapta.ai/dforms/developers/public-api.md
      parameters:
      - name: accountcode
        in: path
        required: true
        schema:
          type: string
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '202':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/public/forms/{accountcode}/{slug}/events:
    post:
      operationId: post_v1_public_forms_accountcode_slug_events
      tags:
      - Public
      summary: Record one funnel event.
      x-source: https://docs.dapta.ai/dforms/developers/public-api.md
      parameters:
      - name: accountcode
        in: path
        required: true
        schema:
          type: string
      - name: slug
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1PublicFormsAccountcodeSlugEventsRequest'
      responses:
        '202':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/public/forms/{accountcode}/{slug}/submissions:
    post:
      operationId: post_v1_public_forms_accountcode_slug_submissions
      tags:
      - Public
      summary: Record a submission.
      x-source: https://docs.dapta.ai/dforms/developers/public-api.md
      parameters:
      - name: accountcode
        in: path
        required: true
        schema:
          type: string
      - name: slug
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1PublicFormsAccountcodeSlugSubmissionsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/public/forms/{accountcode}/{slug}/uploads:
    post:
      operationId: post_v1_public_forms_accountcode_slug_uploads
      tags:
      - Public
      summary: Authorize one file for a File upload question.
      x-source: https://docs.dapta.ai/dforms/developers/public-api.md
      parameters:
      - name: accountcode
        in: path
        required: true
        schema:
          type: string
      - name: slug
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1PublicFormsAccountcodeSlugUploadsRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/public/pages/{accountcode}:
    get:
      operationId: get_v1_public_pages_accountcode
      tags:
      - Public
      summary: 'The workspace page: name, bio, logo, buttons and social links, exactly as the page renders them.'
      x-source: https://docs.dapta.ai/dforms/developers/public-api.md
      parameters:
      - name: accountcode
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1PublicPagesAccountcodeResponse'
      x-evidence:
        kind: documentation
  /v2/bookings:
    post:
      operationId: post_v2_bookings
      tags:
      - Bookings
      summary: Create, hold, reschedule, confirm and decline bookings
      x-source: https://docs.dapta.ai/dcal/developers/api-keys.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/bookings/{uid}:
    get:
      operationId: get_v2_bookings_uid
      tags:
      - Bookings
      summary: Read bookings
      x-source: https://docs.dapta.ai/dcal/developers/api-keys.md
      parameters:
      - name: uid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/bookings/{uid}/cancel:
    post:
      operationId: post_v2_bookings_uid_cancel
      tags:
      - Bookings
      summary: Cancel bookings
      x-source: https://docs.dapta.ai/dcal/developers/api-keys.md
      parameters:
      - name: uid
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/bookings/{uid}/guests:
    post:
      operationId: post_v2_bookings_uid_guests
      tags:
      - Bookings
      summary: Create, hold, reschedule, confirm and decline bookings
      x-source: https://docs.dapta.ai/dcal/developers/api-keys.md
      parameters:
      - name: uid
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/bookings/{uid}/reschedule:
    post:
      operationId: post_v2_bookings_uid_reschedule
      tags:
      - Bookings
      summary: Create, hold, reschedule, confirm and decline bookings
      x-source: https://docs.dapta.ai/dcal/developers/api-keys.md
      parameters:
      - name: uid
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/calendars:
    get:
      operationId: get_v2_calendars
      tags:
      - Calendars
      summary: API keys
      x-source: https://docs.dapta.ai/dcal/developers/api-keys.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/calendars/availability:
    post:
      operationId: post_v2_calendars_availability
      tags:
      - Calendars
      summary: API keys
      x-source: https://docs.dapta.ai/dcal/developers/api-keys.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/event-types:
    get:
      operationId: get_v2_event_types
      tags:
      - Event Types
      summary: API keys
      x-source: https://docs.dapta.ai/dcal/developers/api-keys.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/slots:
    get:
      operationId: get_v2_slots
      tags:
      - Slots
      summary: Check free times
      x-source: https://docs.dapta.ai/dcal/developers/api-keys.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    GetDcalBookingsConfirmOrDeclineMdResponse:
      type: object
      properties:
        body:
          type: string
          description: Markdown content of the Confirm or decline requests documentation page.
    GetDformsDesignClientLogosMdResponse:
      type: object
      properties:
        content:
          type: string
          description: The Markdown content of the requested documentation page.
    GetV1PublicFormsAccountcodeSlugResponse:
      type: object
      properties:
        slug:
          type: string
        name:
          type: string
        config:
          type: object
    PostV1PublicFormsAccountcodeSlugEventsRequest:
      type: object
      properties:
        sessionId:
          type: string
        type:
          type: string
        stepIndex:
          type: string
        stepKey:
          type: string
      required:
      - sessionId
      - type
    PostV1PublicFormsAccountcodeSlugSubmissionsRequest:
      type: object
      properties:
        sessionId:
          type: string
        data:
          type: string
        partial:
          type: string
        locale:
          type: string
        visit:
          type: string
        captchaToken:
          type: string
      required:
      - sessionId
      - data
    PostV1PublicFormsAccountcodeSlugUploadsRequest:
      type: object
      properties:
        sessionId:
          type: string
        stepKey:
          type: string
        name:
          type: string
        size:
          type: string
        mime:
          type: string
      required:
      - sessionId
      - stepKey
      - name
      - size
      - mime
    GetV1PublicPagesAccountcodeResponse:
      type: object
      properties:
        name:
          type: string
        bio:
          type: string
        logo:
          type: string
        buttons:
          type: array
        socialLinks:
          type: array
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Bookings
- name: Calendars
- name: Dapta Mcp
- name: Dcal
- name: Dforms
- name: Event Types
- name: Health
- name: Integrations
- name: Machine
- name: Product Guides
- name: Public
- name: Slots