openapi: 3.2.0
info:
  title: Recall.ai Zoom OAUTH Apps API
  version: 0.0.0
  description: Recall.ai API Documentation
servers:
- url: https://us-east-1.recall.ai
  description: Recall.ai API
- url: https://eu-central-1.recall.ai
  description: European Recall.ai API
- url: https://ap-northeast-1.recall.ai
  description: Asia Recall.ai API
- url: https://us-west-2.recall.ai
  description: Pay-as-you-go Recall.ai API
tags:
- name: zoom-oauth-apps
paths:
  /api/v2/zoom-oauth-app-logs/:
    get:
      operationId: zoom_oauth_app_logs_list
      description: 'Get a list of all Zoom OAuth App Logs. Any warnings or errors related to the OAuth App will be logged here, and this can be helpful for debugging.


        The base rate limit for this endpoint is:

        - 60 requests per min per workspace'
      summary: List Zoom OAuth App Logs
      parameters:
      - in: query
        name: created_at_after
        schema:
          type: string
          format: date-time
      - in: query
        name: created_at_before
        schema:
          type: string
          format: date-time
      - name: cursor
        required: false
        in: query
        description: The pagination cursor value.
        schema:
          type: string
      - in: query
        name: oauth_app
        schema:
          type: string
          format: uuid
      - name: ordering
        required: false
        in: query
        description: Which field to use when ordering the results.
        schema:
          type: string
      tags:
      - zoom-oauth-apps
      security:
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedZoomOAuthAppLogList'
          description: ''
      x-throttles:
      - scope_key: workspace_id
        limit: 60
        period: min
  /api/v2/zoom-oauth-apps/:
    get:
      operationId: zoom_oauth_apps_list
      description: 'Get a list of all Zoom OAuth Apps.


        The base rate limit for this endpoint is:

        - 60 requests per min per workspace'
      summary: List Zoom OAuth Apps
      parameters:
      - in: query
        name: client_id
        schema:
          type: string
      - in: query
        name: created_at_after
        schema:
          type: string
          format: date-time
      - in: query
        name: created_at_before
        schema:
          type: string
          format: date-time
      - name: cursor
        required: false
        in: query
        description: The pagination cursor value.
        schema:
          type: string
      - in: query
        name: kind
        schema:
          type: string
      - name: ordering
        required: false
        in: query
        description: Which field to use when ordering the results.
        schema:
          type: string
      - in: query
        name: webhook_last_validation_after
        schema:
          type: string
          format: date-time
      - in: query
        name: webhook_last_validation_before
        schema:
          type: string
          format: date-time
      tags:
      - zoom-oauth-apps
      security:
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedZoomOAuthAppList'
          description: ''
      x-throttles:
      - scope_key: workspace_id
        limit: 60
        period: min
    post:
      operationId: zoom_oauth_apps_create
      description: 'Create a new Zoom OAuth App.


        The base rate limit for this endpoint is:

        - 300 requests per min per workspace'
      summary: Create Zoom OAuth App
      tags:
      - zoom-oauth-apps
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ZoomOAuthAppRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/ZoomOAuthAppRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/ZoomOAuthAppRequest'
        required: true
      security:
      - tokenAuth: []
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ZoomOAuthApp'
          description: ''
      x-throttles:
      - scope_key: workspace_id
        limit: 300
        period: min
  /api/v2/zoom-oauth-apps/{id}/:
    get:
      operationId: zoom_oauth_apps_retrieve
      description: 'Get a Zoom OAuth App.


        The base rate limit for this endpoint is:

        - 300 requests per min per workspace'
      summary: Retrieve Zoom OAuth App
      parameters:
      - in: path
        name: id
        schema:
          type: string
          format: uuid
        description: A UUID string identifying this zoom o auth app.
        required: true
      tags:
      - zoom-oauth-apps
      security:
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ZoomOAuthApp'
          description: ''
      x-throttles:
      - scope_key: workspace_id
        limit: 300
        period: min
    patch:
      operationId: zoom_oauth_apps_partial_update
      description: 'Update an existing Zoom OAuth App


        The base rate limit for this endpoint is:

        - 300 requests per min per workspace'
      summary: Update Zoom OAuth App
      parameters:
      - in: path
        name: id
        schema:
          type: string
          format: uuid
        description: A UUID string identifying this zoom o auth app.
        required: true
      tags:
      - zoom-oauth-apps
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchedZoomOAuthAppPartialUpdateRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/PatchedZoomOAuthAppPartialUpdateRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/PatchedZoomOAuthAppPartialUpdateRequest'
      security:
      - tokenAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ZoomOAuthApp'
          description: ''
      x-throttles:
      - scope_key: workspace_id
        limit: 300
        period: min
    delete:
      operationId: zoom_oauth_apps_destroy
      description: 'Deletes a Zoom OAuth App.


        The base rate limit for this endpoint is:

        - 300 requests per min per workspace'
      summary: Destroy Zoom OAuth App
      parameters:
      - in: path
        name: id
        schema:
          type: string
          format: uuid
        description: A UUID string identifying this zoom o auth app.
        required: true
      tags:
      - zoom-oauth-apps
      security:
      - tokenAuth: []
      responses:
        '204':
          description: No response body
      x-throttles:
      - scope_key: workspace_id
        limit: 300
        period: min
components:
  schemas:
    ZoomOAuthApp:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        kind:
          $ref: '#/components/schemas/ZoomOAuthAppKindEnum'
        client_id:
          type: string
          maxLength: 200
        client_secret:
          type: string
          maxLength: 200
        webhook_secret:
          type: string
          maxLength: 200
        webhook_last_validation:
          type:
          - string
          - 'null'
          format: date-time
          readOnly: true
        created_at:
          type: string
          format: date-time
          readOnly: true
      required:
      - client_id
      - client_secret
      - created_at
      - id
      - kind
      - webhook_last_validation
      - webhook_secret
    ZoomOAuthAppRequest:
      type: object
      properties:
        kind:
          $ref: '#/components/schemas/ZoomOAuthAppKindEnum'
        client_id:
          type: string
          minLength: 1
          maxLength: 200
        client_secret:
          type: string
          minLength: 1
          maxLength: 200
        webhook_secret:
          type: string
          minLength: 1
          maxLength: 200
      required:
      - client_id
      - client_secret
      - kind
      - webhook_secret
    PaginatedZoomOAuthAppList:
      type: object
      properties:
        next:
          type:
          - string
          - 'null'
        previous:
          type:
          - string
          - 'null'
        results:
          type: array
          items:
            $ref: '#/components/schemas/ZoomOAuthApp'
    ZoomOAuthAppKindEnum:
      enum:
      - user_level
      - account_level
      type: string
      description: '* `user_level` - User Level

        * `account_level` - Account Level'
    PatchedZoomOAuthAppPartialUpdateRequest:
      type: object
      properties:
        webhook_secret:
          type: string
          minLength: 1
        client_secret:
          type: string
          minLength: 1
    ZoomOAuthAppLog:
      type: object
      properties:
        oauth_app:
          type: string
          format: uuid
        message:
          type: string
          maxLength: 2000
        created_at:
          type: string
          format: date-time
          readOnly: true
      required:
      - created_at
      - message
      - oauth_app
    PaginatedZoomOAuthAppLogList:
      type: object
      properties:
        next:
          type:
          - string
          - 'null'
        previous:
          type:
          - string
          - 'null'
        results:
          type: array
          items:
            $ref: '#/components/schemas/ZoomOAuthAppLog'
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Token-based authentication with required prefix "Token"
    CalendarJwtAuthentication:
      type: apiKey
      in: header
      name: x-recallcalendarauthtoken
x-provenance:
  method: searched
  source: https://docs.recall.ai/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.recall.ai/reference/audio_mixed_destroy.md
  - https://docs.recall.ai/reference/audio_mixed_list.md
  - https://docs.recall.ai/reference/audio_mixed_partial_update.md
  - https://docs.recall.ai/reference/audio_mixed_retrieve.md
  - https://docs.recall.ai/reference/audio_separate_destroy.md
  - https://docs.recall.ai/reference/audio_separate_list.md
  - https://docs.recall.ai/reference/audio_separate_partial_update.md
  - https://docs.recall.ai/reference/audio_separate_retrieve.md
  - https://docs.recall.ai/reference/billing_usage_retrieve.md
  - https://docs.recall.ai/reference/bot_create.md
  - https://docs.recall.ai/reference/bot_delete_media_create.md
  - https://docs.recall.ai/reference/bot_destroy.md
  - https://docs.recall.ai/reference/bot_leave_call_create.md
  - https://docs.recall.ai/reference/bot_list.md
  - https://docs.recall.ai/reference/bot_output_audio_create.md
  - https://docs.recall.ai/reference/bot_output_audio_destroy.md
  - https://docs.recall.ai/reference/bot_output_media_create.md
  - https://docs.recall.ai/reference/bot_output_media_destroy.md
  - https://docs.recall.ai/reference/bot_output_screenshare_create.md
  - https://docs.recall.ai/reference/bot_output_screenshare_destroy.md
  - https://docs.recall.ai/reference/bot_output_video_create.md
  - https://docs.recall.ai/reference/bot_output_video_destroy.md
  - https://docs.recall.ai/reference/bot_partial_update.md
  - https://docs.recall.ai/reference/bot_pause_recording_create.md
  - https://docs.recall.ai/reference/bot_pin_participant_create.md
  - https://docs.recall.ai/reference/bot_resume_recording_create.md
  - https://docs.recall.ai/reference/bot_retrieve.md
  - https://docs.recall.ai/reference/bot_send_chat_message_create.md
  - https://docs.recall.ai/reference/bot_start_recording_create.md
  - https://docs.recall.ai/reference/bot_stop_recording_create.md
  - https://docs.recall.ai/reference/calendar_authenticate_create.md
  - https://docs.recall.ai/reference/calendar_events_bot_create.md
  - https://docs.recall.ai/reference/calendar_events_bot_destroy.md
  - https://docs.recall.ai/reference/calendar_events_list.md
  - https://docs.recall.ai/reference/calendar_events_retrieve.md
  - https://docs.recall.ai/reference/calendar_meetings_list.md
  - https://docs.recall.ai/reference/calendar_meetings_refresh_create.md
  - https://docs.recall.ai/reference/calendar_meetings_retrieve.md
  - https://docs.recall.ai/reference/calendar_meetings_update.md
  - https://docs.recall.ai/reference/calendar_user_destroy.md
  - https://docs.recall.ai/reference/calendar_user_disconnect_create.md
  - https://docs.recall.ai/reference/calendar_user_retrieve.md
  - https://docs.recall.ai/reference/calendar_user_update.md
  - https://docs.recall.ai/reference/calendar_users_list.md
  - https://docs.recall.ai/reference/calendars_access_token_create.md
  - https://docs.recall.ai/reference/calendars_create.md
  - https://docs.recall.ai/reference/calendars_destroy.md
  - https://docs.recall.ai/reference/calendars_list.md
  - https://docs.recall.ai/reference/calendars_partial_update.md
  - https://docs.recall.ai/reference/calendars_retrieve.md
  - https://docs.recall.ai/reference/google_login_groups_create.md
  - https://docs.recall.ai/reference/google_login_groups_destroy.md
  - https://docs.recall.ai/reference/google_login_groups_list.md
  - https://docs.recall.ai/reference/google_login_groups_partial_update.md
  - https://docs.recall.ai/reference/google_login_groups_retrieve.md
  - https://docs.recall.ai/reference/google_login_groups_update.md
  - https://docs.recall.ai/reference/google_logins_create.md
  - https://docs.recall.ai/reference/google_logins_destroy.md
  - https://docs.recall.ai/reference/google_logins_list.md
  - https://docs.recall.ai/reference/google_logins_partial_update.md
  - https://docs.recall.ai/reference/google_logins_retrieve.md
  - https://docs.recall.ai/reference/google_logins_update.md
  - https://docs.recall.ai/reference/meeting_direct_connect_create.md
  - https://docs.recall.ai/reference/meeting_direct_connect_list.md
  - https://docs.recall.ai/reference/meeting_direct_connect_retrieve.md
  - https://docs.recall.ai/reference/meeting_metadata_destroy.md
  - https://docs.recall.ai/reference/meeting_metadata_list.md
  - https://docs.recall.ai/reference/meeting_metadata_partial_update.md
  - https://docs.recall.ai/reference/meeting_metadata_retrieve.md
  - https://docs.recall.ai/reference/participant_events_destroy.md
  - https://docs.recall.ai/reference/participant_events_list.md
  - https://docs.recall.ai/reference/participant_events_partial_update.md
  - https://docs.recall.ai/reference/participant_events_retrieve.md
  - https://docs.recall.ai/reference/realtime_endpoint_list.md
  - https://docs.recall.ai/reference/realtime_endpoint_partial_update.md
  - https://docs.recall.ai/reference/realtime_endpoint_retrieve.md
  - https://docs.recall.ai/reference/recording_create_transcript_create.md
  - https://docs.recall.ai/reference/recording_destroy.md
  - https://docs.recall.ai/reference/recording_list.md
  - https://docs.recall.ai/reference/recording_partial_update.md
  - https://docs.recall.ai/reference/recording_retrieve.md
  - https://docs.recall.ai/reference/sdk_upload_create.md
  - https://docs.recall.ai/reference/sdk_upload_list.md
  - https://docs.recall.ai/reference/sdk_upload_retrieve.md
  - https://docs.recall.ai/reference/transcript_destroy.md
  - https://docs.recall.ai/reference/transcript_list.md
  - https://docs.recall.ai/reference/transcript_partial_update.md
  - https://docs.recall.ai/reference/transcript_retrieve.md
  - https://docs.recall.ai/reference/video_mixed_destroy.md
  - https://docs.recall.ai/reference/video_mixed_list.md
  - https://docs.recall.ai/reference/video_mixed_partial_update.md
  - https://docs.recall.ai/reference/video_mixed_retrieve.md
  - https://docs.recall.ai/reference/video_separate_destroy.md
  - https://docs.recall.ai/reference/video_separate_list.md
  - https://docs.recall.ai/reference/video_separate_partial_update.md
  - https://docs.recall.ai/reference/video_separate_retrieve.md
  - https://docs.recall.ai/reference/zoom_meetings_to_credentials_list.md
  - https://docs.recall.ai/reference/zoom_oauth_app_logs_list.md
  - https://docs.recall.ai/reference/zoom_oauth_apps_create.md
  - https://docs.recall.ai/reference/zoom_oauth_apps_destroy.md
  - https://docs.recall.ai/reference/zoom_oauth_apps_list.md
  - https://docs.recall.ai/reference/zoom_oauth_apps_partial_update.md
  - https://docs.recall.ai/reference/zoom_oauth_apps_retrieve.md
  - https://docs.recall.ai/reference/zoom_oauth_credential_logs_list.md
  - https://docs.recall.ai/reference/zoom_oauth_credentials_access_token_retrieve.md
  - https://docs.recall.ai/reference/zoom_oauth_credentials_create.md
  - https://docs.recall.ai/reference/zoom_oauth_credentials_destroy.md
  - https://docs.recall.ai/reference/zoom_oauth_credentials_list.md
  - https://docs.recall.ai/reference/zoom_oauth_credentials_retrieve.md
  - https://docs.recall.ai/reference/zoom_oauth_credentials_sync_meetings_create.md
  - https://docs.recall.ai/reference/zoom_oauth_credentials_validate_create.md
  merge:
    pages: 111
    deduped: 2254
    conflicts_kept_first: 0