Wispr AI Connectors API

The Connectors API from Wispr AI — 6 operation(s) for connectors.

Operations 6

POST /api/v1/connectors/connect Initiate Connection #
POST /api/v1/connectors/raw_connect Raw Initiate Connection #
GET /api/v1/connectors/connection/{connection_id}/status Get Connection Status #
GET /api/v1/connectors List Connectors #
POST /api/v1/connectors/disconnect Disconnect #
POST /api/v1/connectors/list_calendar_events List Calendar Events #

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/wispr-ai-connectors-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.

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

OpenAPI Specification

wispr-ai-connectors-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Wispr Backend Analytics Connectors API
  description: Wispr Backend API
  version: 0.5.2
servers:
- url: https://api.wisprflow.ai
  description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: Connectors
paths:
  /api/v1/connectors/connect:
    post:
      tags:
      - Connectors
      summary: Initiate Connection
      operationId: initiate_connection
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InitiateConnectionRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InitiateConnectionResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - ApiKeyHeaderPatched: []
  /api/v1/connectors/raw_connect:
    post:
      tags:
      - Connectors
      summary: Raw Initiate Connection
      description: 'Solely meant for prototypes. This endpoint directly forwards a connection request to the underlying connector implementation.


        Production code should use the `/connect` endpoint, as that is the only way to have a stable API

        through provider changes. Users of this endpoint should assume breaking changes might occur arbitrarily.'
      operationId: raw_initiate_connection
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RawInitiateConnectionRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InitiateConnectionResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - ApiKeyHeaderPatched: []
  /api/v1/connectors/connection/{connection_id}/status:
    get:
      tags:
      - Connectors
      summary: Get Connection Status
      operationId: get_connection_status
      security:
      - ApiKeyHeaderPatched: []
      parameters:
      - name: connection_id
        in: path
        required: true
        schema:
          type: string
          title: Connection Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectionStatusResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/connectors:
    get:
      tags:
      - Connectors
      summary: List Connectors
      operationId: list_connectors
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorsResponse'
      security:
      - ApiKeyHeaderPatched: []
  /api/v1/connectors/disconnect:
    post:
      tags:
      - Connectors
      summary: Disconnect
      operationId: disconnect
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DisconnectRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DisconnectResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - ApiKeyHeaderPatched: []
  /api/v1/connectors/list_calendar_events:
    post:
      tags:
      - Connectors
      summary: List Calendar Events
      operationId: list_calendar_events
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListCalendarEventsRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListCalendarEventsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - ApiKeyHeaderPatched: []
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    ListCalendarEventsResponse:
      properties:
        successful:
          type: boolean
          title: Successful
        error:
          anyOf:
          - type: string
          - type: 'null'
          title: Error
        data:
          items:
            $ref: '#/components/schemas/GoogleCalendarEvent'
          type: array
          title: Data
      type: object
      required:
      - successful
      title: ListCalendarEventsResponse
    GoogleCalendarEvent:
      properties:
        summary:
          type: string
          title: Summary
          default: ''
        description:
          type: string
          title: Description
          default: ''
        start:
          type: string
          format: date-time
          title: Start
        end:
          type: string
          format: date-time
          title: End
        organizer:
          anyOf:
          - type: string
          - type: 'null'
          title: Organizer
        attendees:
          items:
            type: string
          type: array
          title: Attendees
        url:
          anyOf:
          - type: string
          - type: 'null'
          title: Url
      type: object
      required:
      - start
      - end
      title: GoogleCalendarEvent
    ConnectorInfo:
      properties:
        key:
          $ref: '#/components/schemas/ConnectorKey'
        label:
          type: string
          title: Label
        connected:
          type: boolean
          title: Connected
        incomplete_scopes:
          type: boolean
          title: Incomplete Scopes
          default: false
        connected_email:
          anyOf:
          - type: string
          - type: 'null'
          title: Connected Email
      type: object
      required:
      - key
      - label
      - connected
      title: ConnectorInfo
    ListCalendarEventsRequest:
      properties:
        time_min:
          type: string
          format: date-time
          title: Time Min
        time_max:
          type: string
          format: date-time
          title: Time Max
        max_results:
          anyOf:
          - type: integer
          - type: 'null'
          title: Max Results
      type: object
      required:
      - time_min
      - time_max
      title: ListCalendarEventsRequest
      description: Request to list calendar events within a time window.
    ConnectorsResponse:
      properties:
        connectors:
          items:
            $ref: '#/components/schemas/ConnectorInfo'
          type: array
          title: Connectors
      type: object
      required:
      - connectors
      title: ConnectorsResponse
      description: The list of connectors and their status for the user.
    InitiateConnectionResponse:
      properties:
        connection_id:
          type: string
          title: Connection Id
        redirect_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Redirect Url
      type: object
      required:
      - connection_id
      title: InitiateConnectionResponse
    DisconnectResponse:
      properties:
        successful:
          type: boolean
          title: Successful
      type: object
      required:
      - successful
      title: DisconnectResponse
    ConnectorKey:
      type: string
      enum:
      - calendar
      - github
      - gmail
      - linear
      - notion
      - slack
      - wispr
      title: ConnectorKey
      x-enum-varnames:
      - Calendar
      - Github
      - GoogleAutomations
      - Linear
      - Notion
      - Slack
      - Wispr
    RawInitiateConnectionRequest:
      properties:
        app:
          type: string
          title: App
        callback_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Callback Url
      type: object
      required:
      - app
      title: RawInitiateConnectionRequest
      description: Request to start connecting a connector identified by a raw app string.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    InitiateConnectionRequest:
      properties:
        key:
          $ref: '#/components/schemas/ConnectorKey'
        callback_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Callback Url
      type: object
      required:
      - key
      title: InitiateConnectionRequest
      description: Request to start connecting a connector identified by its key.
    ConnectionStatusResponse:
      properties:
        connection_id:
          type: string
          title: Connection Id
        status:
          $ref: '#/components/schemas/ConnectorStatus'
        toolkit_slug:
          type: string
          title: Toolkit Slug
        incomplete_scopes:
          type: boolean
          title: Incomplete Scopes
          default: false
      type: object
      required:
      - connection_id
      - status
      - toolkit_slug
      title: ConnectionStatusResponse
    DisconnectRequest:
      properties:
        key:
          $ref: '#/components/schemas/ConnectorKey'
      type: object
      required:
      - key
      title: DisconnectRequest
      description: Request to disconnect a connector identified by its key.
    ConnectorStatus:
      type: string
      enum:
      - pending
      - active
      - failed
      title: ConnectorStatus
  securitySchemes:
    ApiKeyHeaderPatched:
      type: apiKey
      in: header
      name: Authorization
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key