Configure Connectors API

The Connectors API from Configure — 23 operation(s) for connectors.

GitHub OpenAPI

Operations 23

GET /v1/connectors List connector status #
POST /v1/connectors/{connector}/connect Start connector OAuth #
POST /v1/connectors/{connector}/confirm Confirm connector OAuth #
POST /v1/connectors/{connector}/sync Sync one connector #
DELETE /v1/connectors/{connector} Disconnect one connector #
POST /v1/connectors/disconnect-all Disconnect all connectors and reset profile files #
POST /v1/connectors/sync Sync selected connectors #
POST /v1/connectors/gmail/messages/search Search Gmail #
POST /v1/connectors/outlook/messages/search Search Outlook #
POST /v1/connectors/email/messages/search Search hosted email providers #
POST /v1/connectors/calendar/events/query Read calendar events #
POST /v1/connectors/drive/files/search Search Drive files #
POST /v1/connectors/notion/pages/search Search Notion #
POST /v1/connectors/sheets/spreadsheets/search Search Google Sheets #
POST /v1/connectors/sheets/values/get Read Google Sheets values #
POST /v1/connectors/calendar/events Create calendar event #
POST /v1/connectors/gmail/messages/send Send email #
POST /v1/connectors/outlook/messages/send Send Outlook email #
POST /v1/connectors/email/messages/send Send hosted email #
POST /v1/connectors/sheets/values/update Update Google Sheets values #
POST /v1/connectors/sheets/values/append Append Google Sheets values #
POST /v1/connectors/sheets/spreadsheets Create Google spreadsheet #
POST /v1/connectors/sheets/sheets Add Google Sheets tab #

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/configure-dev:configure-dev-connectors-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

configure-dev-connectors-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Configure Dev Connectors API
  version: 2026-07-12
  description: 'Operations tagged Connectors across 2 of this provider''s published API definitions: configure-dev-openapi-original.yaml, configure-dev-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.configure.dev
  description: Production
- url: https://configure-backend-staging.fly.dev
  description: Staging
security:
- ApiKeyAuth: []
tags:
- name: Connectors
paths:
  /v1/connectors:
    get:
      tags:
      - Connectors
      summary: List connector status
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      responses:
        '200':
          description: Available connectors.
          content:
            application/json:
              schema:
                type: object
                properties:
                  connectors:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
      operationId: getV1Connectors
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/{connector}/connect:
    post:
      tags:
      - Connectors
      summary: Start connector OAuth
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      - $ref: '#/components/parameters/ConnectorPath'
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                callbackUrl:
                  type: string
                  format: uri
                returnUrl:
                  type: string
                  format: uri
                forceNew:
                  type: boolean
      responses:
        '200':
          description: OAuth URL or existing connection.
      operationId: postV1ConnectorsByConnectorConnect
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/{connector}/confirm:
    post:
      tags:
      - Connectors
      summary: Confirm connector OAuth
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      - $ref: '#/components/parameters/ConnectorPath'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - connectionRequestId
              properties:
                connectionRequestId:
                  type: string
      responses:
        '200':
          description: Connection result.
      operationId: postV1ConnectorsByConnectorConfirm
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/{connector}/sync:
    post:
      tags:
      - Connectors
      summary: Sync one connector
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      - $ref: '#/components/parameters/ConnectorPath'
      responses:
        '200':
          description: Sync result.
      operationId: postV1ConnectorsByConnectorSync
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/{connector}:
    delete:
      tags:
      - Connectors
      summary: Disconnect one connector
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      - $ref: '#/components/parameters/ConnectorPath'
      responses:
        '200':
          description: Disconnect result.
      operationId: deleteV1ConnectorsByConnector
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/disconnect-all:
    post:
      tags:
      - Connectors
      summary: Disconnect all connectors and reset profile files
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      responses:
        '200':
          description: Disconnect result.
      operationId: postV1ConnectorsDisconnectAll
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/sync:
    post:
      tags:
      - Connectors
      summary: Sync selected connectors
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SyncRequest'
      responses:
        '200':
          description: Sync result.
      operationId: postV1ConnectorsSync
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/gmail/messages/search:
    post:
      tags:
      - Connectors
      summary: Search Gmail
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes. Omit account to search all connected Gmail accounts; results then include accounts_searched and partial when some accounts fail.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GmailSearchRequest'
      responses:
        '200':
          description: Email search results.
      operationId: postV1ConnectorsGmailMessagesSearch
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/outlook/messages/search:
    post:
      tags:
      - Connectors
      summary: Search Outlook
      description: Search one or every permitted connected Outlook account. Requires X-API-Key plus an agent-scoped Bearer token from Configure.link().
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EmailAccountSearchRequest'
      responses:
        '200':
          description: Outlook search results with account provenance.
      operationId: postV1ConnectorsOutlookMessagesSearch
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/email/messages/search:
    post:
      tags:
      - Connectors
      summary: Search hosted email providers
      description: Search every permitted Gmail and Outlook account by default. Partial responses report accounts_searched and partial=true.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HostedEmailSearchRequest'
      responses:
        '200':
          description: Provider-neutral email search results with provider and account provenance.
      operationId: postV1ConnectorsEmailMessagesSearch
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/calendar/events/query:
    post:
      tags:
      - Connectors
      summary: Read calendar events
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CalendarRequest'
      responses:
        '200':
          description: Calendar results.
      operationId: postV1ConnectorsCalendarEventsQuery
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/drive/files/search:
    post:
      tags:
      - Connectors
      summary: Search Drive files
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchRequest'
      responses:
        '200':
          description: File search results.
      operationId: postV1ConnectorsDriveFilesSearch
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/notion/pages/search:
    post:
      tags:
      - Connectors
      summary: Search Notion
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchRequest'
      responses:
        '200':
          description: Notion search results.
      operationId: postV1ConnectorsNotionPagesSearch
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/sheets/spreadsheets/search:
    post:
      tags:
      - Connectors
      summary: Search Google Sheets
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchRequest'
      responses:
        '200':
          description: Spreadsheet search results.
      operationId: postV1ConnectorsSheetsSpreadsheetsSearch
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/sheets/values/get:
    post:
      tags:
      - Connectors
      summary: Read Google Sheets values
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SheetValuesGetRequest'
      responses:
        '200':
          description: Spreadsheet values.
      operationId: postV1ConnectorsSheetsValuesGet
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/calendar/events:
    post:
      tags:
      - Connectors
      summary: Create calendar event
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateEventRequest'
      responses:
        '200':
          description: Event creation result.
      operationId: postV1ConnectorsCalendarEvents
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/gmail/messages/send:
    post:
      tags:
      - Connectors
      summary: Send email
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendEmailRequest'
      responses:
        '200':
          description: Send result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SendEmailResponse'
      operationId: postV1ConnectorsGmailMessagesSend
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/outlook/messages/send:
    post:
      tags:
      - Connectors
      summary: Send Outlook email
      description: Send from a selected or default permitted Outlook account. Requires X-API-Key plus an agent-scoped Bearer token from Configure.link().
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendEmailRequest'
      responses:
        '200':
          description: Send result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SendEmailResponse'
      operationId: postV1ConnectorsOutlookMessagesSend
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/email/messages/send:
    post:
      tags:
      - Connectors
      summary: Send hosted email
      description: Send from a permitted Gmail or Outlook account. Provider ambiguity fails closed with email_account_selection_required.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HostedSendEmailRequest'
      responses:
        '200':
          description: Send result with provider and account provenance.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SendEmailResponse'
      operationId: postV1ConnectorsEmailMessagesSend
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/sheets/values/update:
    post:
      tags:
      - Connectors
      summary: Update Google Sheets values
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SheetValuesMutationRequest'
      responses:
        '200':
          description: Values update result.
      operationId: postV1ConnectorsSheetsValuesUpdate
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/sheets/values/append:
    post:
      tags:
      - Connectors
      summary: Append Google Sheets values
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SheetValuesMutationRequest'
      responses:
        '200':
          description: Values append result.
      operationId: postV1ConnectorsSheetsValuesAppend
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/sheets/spreadsheets:
    post:
      tags:
      - Connectors
      summary: Create Google spreadsheet
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSpreadsheetRequest'
      responses:
        '200':
          description: Spreadsheet creation result.
      operationId: postV1ConnectorsSheetsSpreadsheets
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
  /v1/connectors/sheets/sheets:
    post:
      tags:
      - Connectors
      summary: Add Google Sheets tab
      description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
      security:
      - ApiKeyAuth: []
        BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/AgentHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddSheetRequest'
      responses:
        '200':
          description: Sheet tab creation result.
      operationId: postV1ConnectorsSheetsSheets
      x-operation-id-source: derived
    servers:
    - url: https://api.configure.dev
      description: Production
    - url: https://configure-backend-staging.fly.dev
      description: Staging
components:
  parameters:
    AgentHeader:
      name: X-Agent
      in: header
      required: false
      schema:
        $ref: '#/components/schemas/AgentName'
      description: Required when the API key's developer account owns more than one active agent.
    ConnectorPath:
      name: connector
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/ConnectorName'
  schemas:
    SyncRequest:
      type: object
      additionalProperties: false
      properties:
        connectors:
          type: array
          items:
            $ref: '#/components/schemas/ConnectorName'
    HostedSendEmailRequest:
      type: object
      additionalProperties: false
      required:
      - to
      - subject
      - body
      properties:
        to:
          type: string
          format: email
        subject:
          type: string
          minLength: 1
          maxLength: 500
        body:
          type: string
          minLength: 1
          maxLength: 50000
        provider:
          type: string
          enum:
          - gmail
          - outlook
        account:
          type: string
          minLength: 3
          maxLength: 200
    SearchRequest:
      type: object
      additionalProperties: false
      required:
      - query
      properties:
        query:
          type: string
          minLength: 1
        max_results:
          type: integer
          default: 10
          minimum: 1
          maximum: 50
    SendEmailRequest:
      type: object
      additionalProperties: false
      required:
      - to
      - subject
      - body
      properties:
        to:
          type: string
          format: email
        subject:
          type: string
          minLength: 1
          maxLength: 500
        body:
          type: string
          minLength: 1
          maxLength: 50000
        account:
          type: string
          minLength: 3
          maxLength: 200
          description: Connected Gmail account ID or email to send from. Omitted, the user's default Gmail account sends.
    CreateEventRequest:
      type: object
      additionalProperties: false
      required:
      - title
      - start_time
      - end_time
      properties:
        title:
          type: string
          minLength: 1
          maxLength: 500
        start_time:
          type: string
        end_time:
          type: string
        description:
          type: string
          maxLength: 5000
        location:
          type: string
          maxLength: 500
    CreateSpreadsheetRequest:
      type: object
      additionalProperties: false
      required:
      - title
      properties:
        title:
          type: string
          minLength: 1
          maxLength: 255
    SheetValuesMutationRequest:
      type: object
      additionalProperties: false
      required:
      - spreadsheet_id
      - range
      - values
      properties:
        spreadsheet_id:
          type: string
          minLength: 1
          maxLength: 255
        range:
          type: string
          minLength: 1
          maxLength: 500
        values:
          type: array
          minItems: 1
          maxItems: 500
          items:
            type: array
            maxItems: 200
            items: {}
        value_input_option:
          type: string
          enum:
          - USER_ENTERED
          - RAW
          default: USER_ENTERED
    CalendarRequest:
      type: object
      additionalProperties: false
      properties:
        range:
          type: string
          enum:
          - today
          - tomorrow
          - week
          - month
          default: week
    EmailAccountSearchRequest:
      type: object
      additionalProperties: false
      required:
      - query
      properties:
        query:
          type: string
          minLength: 1
        max_results:
          type: integer
          default: 10
          minimum: 1
          maximum: 50
        account:
          type: string
          minLength: 3
          maxLength: 200
          description: Connected account ID or email. Omitted, all permitted accounts for the endpoint provider are searched.
    SheetValuesGetRequest:
      type: object
      additionalProperties: false
      required:
      - spreadsheet_id
      - ranges
      properties:
        spreadsheet_id:
          type: string
          minLength: 1
          maxLength: 255
        ranges:
          type: array
          minItems: 1
          maxItems: 10
          items:
            type: string
            minLength: 1
            maxLength: 500
    AddSheetRequest:
      type: object
      additionalProperties: false
      required:
      - spreadsheet_id
      - title
      properties:
        spreadsheet_id:
          type: string
          minLength: 1
          maxLength: 255
        title:
          type: string
          minLength: 1
          maxLength: 100
        row_count:
          type: integer
          minimum: 1
          maximum: 10000
        column_count:
          type: integer
          minimum: 1
          maximum: 1000
    SendEmailResponse:
      type: object
      additionalProperties: false
      required:
      - sent
      - email
      - message
      properties:
        sent:
          type: boolean
          description: True only when Gmail returned a provider message id. False with delivery_status=unconfirmed when the provider completed the request without an id.
        retryable:
          type: boolean
          description: False when delivery is unconfirmed because retrying could send a duplicate email.
        email:
          type: object
          additionalProperties: true
          required:
          - to
          - subject
          - body_preview
          - delivery_status
          properties:
            to:
              type: string
              format: email
            subject:
              type: string
            body_preview:
              type: string
            delivery_status:
              type: string
              enum:
              - accepted
              - unconfirmed
              description: Accepted means Gmail returned a provider message id. Unconfirmed means the provider completed the request without an id; do not retry automatically.
            provider_message_id:
              type: string
              description: Gmail message id returned by the provider. Present when delivery_status is accepted.
            from_account:
              type: object
              additionalProperties: false
              properties:
                id:
                  type: string
                email:
                  type: string
                  format: email
            gmail_data:
              description: Raw Gmail/connector response data retained for diagnostics.
        message:
          type: string
    HostedEmailSearchRequest:
      type: object
      additionalProperties: false
      required:
      - query
      properties:
        query:
          type: string
          minLength: 1
        max_results:
          type: integer
          default: 10
          minimum: 1
          maximum: 50
        provider:
          type: string
          enum:
          - gmail
          - outlook
        account:
          type: string
          minLength: 3
          maxLength: 200
    ConnectorName:
      type: string
      enum:
      - gmail
      - outlook
      - calendar
      - drive
      - notion
      - sheets
    GmailSearchRequest:
      type: object
      additionalProperties: false
      required:
      - query
      properties:
        query:
          type: string
          minLength: 1
        max_results:
          type: integer
          default: 10
          minimum: 1
          maximum: 50
        account:
          type: string
          minLength: 3
          maxLength: 200
          description: Connected Gmail account ID or email. Omitted, all connected Gmail accounts are searched.
    AgentName:
      type: string
      minLength: 2
      maxLength: 63
      pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$
      example: your-agent
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Configure API key. Use sk_ on servers. pk_ is browser-safe but restricted.
    SecretApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Server-side Configure secret key, prefix sk_.
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Agent-scoped Configure token from hosted Configure.link().
    ExternalUserId:
      type: apiKey
      in: header
      name: X-User-Id
      description: Stable external user ID for unlinked developer-scoped profiles. Requires sk_.
x-refined-from:
- configure-dev-openapi-original.yaml
- configure-dev-openapi.yml