> ## Documentation Index
> Fetch the complete documentation index at: https://blackbox.dasha.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Verify provider

> Triggers a comprehensive verification of the provider integration.
Validates credentials, checks SIP trunk configuration, verifies credential lists, and confirms phone number attachments.
Updates the provider's verification status and returns detailed check results for troubleshooting.

## Verification Checks

The verification process performs the following checks:

* **Credentials**: Validates that the provider's API credentials are still valid and have sufficient permissions
* **Trunk**: Verifies the SIP trunk exists and is properly configured
* **Credential List**: Confirms the credential list is attached to the trunk
* **Phone Numbers**: Checks that imported phone numbers are still attached to the trunk

## Verification Status

Based on the check results, the provider status is updated to one of:

| Status       | Description                                                    |
| ------------ | -------------------------------------------------------------- |
| **verified** | All checks passed successfully                                 |
| **warning**  | Non-critical issues detected (e.g., phone detached from trunk) |
| **failed**   | Critical failure (e.g., invalid credentials, trunk not found)  |

## Automatic Verification

Providers are automatically verified on an hourly schedule. Use this endpoint to trigger an immediate verification when needed.


## OpenAPI

````yaml https://blackbox.dasha.ai/swagger/v1/swagger.json post /api/v1/providers/{id}/verify
openapi: 3.0.4
info:
  title: Dasha BlackBox Agent API
  description: API for managing AI agents and calls
  contact:
    name: DashaAI Team
    email: support@dasha.ai
  version: v1
servers:
  - url: https://blackbox.dasha.ai
    description: Dasha BlackBox Agent API
security:
  - ApiKey: []
  - OAuth: []
tags:
  - name: ActivityLogs
  - name: Agents
  - name: AgentTestCases
  - name: CallResults
  - name: Calls
  - name: Chats
  - name: Copilot
  - name: CustomerData
  - name: Mcp
  - name: Media
  - name: Misc
  - name: PronunciationDictionaries
  - name: Providers
  - name: SipAliases
  - name: SipCredentials
  - name: SipPhoneNumbers
  - name: TextChat
  - name: TwilioProvider
  - name: Voice
  - name: WebhookTest
  - name: WebIntegrations
  - name: WebSocket
    description: WebSocket endpoints for real-time communication
paths:
  /api/v1/providers/{id}/verify:
    post:
      tags:
        - Providers
      summary: Verify provider
      description: >-
        Triggers a comprehensive verification of the provider integration.

        Validates credentials, checks SIP trunk configuration, verifies
        credential lists, and confirms phone number attachments.

        Updates the provider's verification status and returns detailed check
        results for troubleshooting.
      parameters:
        - name: id
          in: path
          description: Provider identifier
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Verification completed successfully with detailed results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerificationResultDto'
        '401':
          description: Authentication failed or API key is missing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Access denied to the requested resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: Provider with specified ID does not exist in your organization
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '500':
          description: Server error occurred during verification
components:
  schemas:
    VerificationResultDto:
      type: object
      properties:
        status:
          allOf:
            - $ref: '#/components/schemas/VerificationStatus'
          description: >-
            Overall verification status. Indicates the aggregate result of all
            verification checks.

            Supported values: pending, verified, warning, failed.
        checks:
          type: array
          items:
            $ref: '#/components/schemas/VerificationCheckDto'
          description: >-
            Individual verification check results. Contains details about each
            check performed

            including credentials validation, API connectivity, and
            configuration verification.
          nullable: true
        lastVerifiedAt:
          type: string
          description: Timestamp when the verification was performed. Recorded in UTC.
          format: date-time
      additionalProperties: false
      description: >-
        Result of a provider verification operation. Contains the overall
        verification status,

        individual check results, and timestamp of when the verification was
        performed.
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
      additionalProperties: {}
    VerificationStatus:
      enum:
        - pending
        - verified
        - warning
        - failed
      type: string
      description: >-
        Status of provider credential verification. Indicates the current health
        and validity of the provider integration.
    VerificationCheckDto:
      required:
        - checkName
        - message
      type: object
      properties:
        checkName:
          type: string
          description: >-
            Name of the verification check that was performed.

            Common values: credentials, api_connectivity, sip_trunk,
            phone_numbers.
          nullable: true
        status:
          allOf:
            - $ref: '#/components/schemas/CheckStatus'
          description: >-
            Status indicating whether the check passed, failed, or raised a
            warning.

            Supported values: passed, failed, warning.
        message:
          type: string
          description: >-
            Human-readable message describing the check result. Provides context
            about

            what was verified and any issues encountered.
          nullable: true
        timestamp:
          type: string
          description: Timestamp when the check was performed. Recorded in UTC.
          format: date-time
        details:
          type: object
          additionalProperties:
            type: string
          description: >-
            Additional details about the check result as key-value pairs.

            Can contain provider-specific information such as error codes or
            configuration details.
          nullable: true
      additionalProperties: false
      description: >-
        DTO representing the result of an individual verification check for a
        provider.

        Contains details about what was checked, the outcome, and any additional
        context.
    CheckStatus:
      enum:
        - passed
        - failed
        - warning
      type: string
      description: >-
        Status of an individual verification check. Indicates whether a specific
        verification check passed, failed, or raised a warning.
  securitySchemes:
    ApiKey:
      type: http
      description: API Key Authentication (Bearer {key})
      scheme: Bearer
    OAuth:
      type: oauth2
      flows:
        implicit:
          authorizationUrl: https://auth.dasha.ai/connect/authorize
          scopes:
            platform_api: Platform API

````