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/dialogbrain-com:dialogbrain-com-integration-auth-configs-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: DialogBrain v2 API Gateway Integration Auth Configs API
  description: Clean refactored API gateway with minimal vertical slice
  version: 0.1.0
tags:
- name: integration-auth-configs
paths:
  /api/integration-auth-configs/:
    get:
      tags:
      - integration-auth-configs
      summary: List Auth Configs Endpoint
      description: 'List auth configs and managed providers.


        GET /api/integration-auth-configs


        Returns:

        {

        "my_configs": [

        {

        "id": 1,

        "workspace_id": 100,

        "provider": "google",

        "management": "managed",

        "auth_scheme": "oauth2",

        "scopes": [...],

        "name": "My Config",

        "status": "enabled",

        "created_at": "...",

        "updated_at": "..."

        }

        ],

        "managed_providers": [

        {

        "provider": "google",

        "verified_scopes": [...]

        }

        ]

        }


        No secret fields are returned.'
      operationId: list_auth_configs_endpoint_api_integration_auth_configs__get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthConfigListResponse'
    post:
      tags:
      - integration-auth-configs
      summary: Create Auth Config Endpoint
      description: 'Create an auth config.


        POST /api/integration-auth-configs

        {

        "provider": "google",

        "management": "managed",

        "auth_scheme": "oauth2",

        "scopes": ["https://www.googleapis.com/auth/gmail.readonly"],

        "name": "My Google Config",

        "custom_client": null # required only if management=''custom''

        }


        Returns 201 with {"id": }.

        Returns 422 if managed scope not verified.

        Returns 400 if custom without custom_client or invalid status.'
      operationId: create_auth_config_endpoint_api_integration_auth_configs__post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AuthConfigCreate'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Create Auth Config Endpoint Api Integration Auth Configs  Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/integration-auth-configs/{config_id}:
    patch:
      tags:
      - integration-auth-configs
      summary: Update Auth Config Endpoint
      description: 'Update an auth config (name and/or status only).


        PATCH /api/integration-auth-configs/{id}

        {

        "name": "Updated Name",

        "status": "disabled"

        }


        Provider, management, and scopes are immutable.


        Returns 200 with updated config.

        Returns 404 if config not found or belongs to different workspace.

        Returns 400 if status is invalid.'
      operationId: update_auth_config_endpoint_api_integration_auth_configs__config_id__patch
      parameters:
      - name: config_id
        in: path
        required: true
        schema:
          type: integer
          title: Config Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AuthConfigUpdate'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthConfigResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - integration-auth-configs
      summary: Delete Auth Config Endpoint
      description: 'Delete an auth config.


        DELETE /api/integration-auth-configs/{id}


        Returns 200 with {"status": "deleted"}.

        Returns 404 if config not found or belongs to different workspace.

        Returns 409 if active connections exist.'
      operationId: delete_auth_config_endpoint_api_integration_auth_configs__config_id__delete
      parameters:
      - name: config_id
        in: path
        required: true
        schema:
          type: integer
          title: Config Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/integration-auth-configs/{config_id}/connections:
    get:
      tags:
      - integration-auth-configs
      summary: List Connections Endpoint
      description: 'List connections for an auth config.


        GET /api/integration-auth-configs/{id}/connections


        Returns list of connections without token_ref or secrets.


        Returns 404 if config not found or belongs to different workspace.'
      operationId: list_connections_endpoint_api_integration_auth_configs__config_id__connections_get
      parameters:
      - name: config_id
        in: path
        required: true
        schema:
          type: integer
          title: Config Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ConnectionResponse'
                title: Response List Connections Endpoint Api Integration Auth Configs  Config Id  Connections Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AuthConfigCreate:
      properties:
        provider:
          type: string
          minLength: 1
          title: Provider
        management:
          type: string
          pattern: ^(managed|custom)$
          title: Management
        auth_scheme:
          type: string
          minLength: 1
          title: Auth Scheme
        scopes:
          items:
            type: string
          type: array
          title: Scopes
        name:
          type: string
          minLength: 1
          title: Name
        custom_client:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
          title: Custom Client
      type: object
      required:
      - provider
      - management
      - auth_scheme
      - name
      title: AuthConfigCreate
      description: Create an auth config (managed or custom).
    ConnectionResponse:
      properties:
        id:
          type: integer
          title: Id
        auth_config_id:
          type: integer
          title: Auth Config Id
        end_user_ref:
          anyOf:
          - type: string
          - type: 'null'
          title: End User Ref
        status:
          type: string
          title: Status
        expires_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Expires At
        scopes:
          items:
            type: string
          type: array
          title: Scopes
        connected_at:
          type: string
          title: Connected At
        connected_by:
          anyOf:
          - type: integer
          - type: 'null'
          title: Connected By
        last_refreshed_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Last Refreshed At
        revoked_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Revoked At
      type: object
      required:
      - id
      - auth_config_id
      - end_user_ref
      - status
      - expires_at
      - scopes
      - connected_at
      - connected_by
      - last_refreshed_at
      - revoked_at
      title: ConnectionResponse
      description: Integration connection (no token_ref).
    AuthConfigResponse:
      properties:
        id:
          type: integer
          title: Id
        workspace_id:
          type: integer
          title: Workspace Id
        provider:
          type: string
          title: Provider
        management:
          type: string
          title: Management
        auth_scheme:
          type: string
          title: Auth Scheme
        scopes:
          items:
            type: string
          type: array
          title: Scopes
        name:
          type: string
          title: Name
        status:
          type: string
          title: Status
        created_at:
          type: string
          title: Created At
        updated_at:
          type: string
          title: Updated At
      type: object
      required:
      - id
      - workspace_id
      - provider
      - management
      - auth_scheme
      - scopes
      - name
      - status
      - created_at
      - updated_at
      title: AuthConfigResponse
      description: Auth config with no secrets.
    AuthConfigUpdate:
      properties:
        name:
          anyOf:
          - type: string
            minLength: 1
          - type: 'null'
          title: Name
        status:
          anyOf:
          - type: string
            pattern: ^(enabled|disabled)$
          - type: 'null'
          title: Status
      type: object
      title: AuthConfigUpdate
      description: Update an auth config (name/status only; provider/management/scopes immutable).
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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
    ManagedProviderResponse:
      properties:
        provider:
          type: string
          title: Provider
        verified_scopes:
          items:
            type: string
          type: array
          title: Verified Scopes
      type: object
      required:
      - provider
      - verified_scopes
      title: ManagedProviderResponse
      description: Available managed OAuth provider.
    AuthConfigListResponse:
      properties:
        my_configs:
          items:
            $ref: '#/components/schemas/AuthConfigResponse'
          type: array
          title: My Configs
        managed_providers:
          items:
            $ref: '#/components/schemas/ManagedProviderResponse'
          type: array
          title: Managed Providers
      type: object
      required:
      - my_configs
      - managed_providers
      title: AuthConfigListResponse
      description: Two-list GET response.