> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agents.labs.bandwidth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Test a call by agent UUID

> Place a test call using an agent UUID.

Requires a Labs `super_user` OAuth bearer token plus Editor, Admin, or Owner. This places a real test call and can incur usage. Use the agent UUID from the agent response, not its numeric ID. Confirm provider configuration, destination, and quota before submission. API keys are not accepted.


## OpenAPI

````yaml POST /api/v1/public/agent/test/workflow/{workflow_uuid}
openapi: 3.1.0
info:
  title: Bandwidth Agent Builder API
  version: v1
  description: >-
    Manage agents, place calls, and retrieve conversation results in your
    workspace.
servers:
  - url: https://agents.labs.bandwidth.com
    description: Workspace API
security: []
paths:
  /api/v1/public/agent/test/workflow/{workflow_uuid}:
    post:
      tags:
        - calls
      summary: Test a call by agent UUID
      description: >-
        **Authorization:** Requires a Labs OAuth bearer token with the
        `super_user` role and an Editor, Admin, or Owner role in the selected
        workspace. API keys are not accepted.


        Place a test call using an agent UUID.
      operationId: >-
        initiate_call_test_by_workflow_uuid_api_v1_public_agent_test_workflow__workflow_uuid__post
      parameters:
        - in: path
          name: workflow_uuid
          required: true
          schema:
            title: Workflow Uuid
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerCallRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TriggerCallResponse'
          description: Successful Response
        '401':
          description: Missing, invalid, or expired credential.
        '403':
          description: >-
            The account lacks access to the workspace, resource, or required
            role.
        '404':
          description: Not found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - LabsAuth: []
components:
  schemas:
    TriggerCallRequest:
      properties:
        initial_context:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Initial Context
        phone_number:
          title: Phone Number
          type: string
        telephony_configuration_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Telephony Configuration Id
      required:
        - phone_number
      title: TriggerCallRequest
      type: object
    TriggerCallResponse:
      properties:
        status:
          title: Status
          type: string
        workflow_run_id:
          title: Workflow Run Id
          type: integer
        workflow_run_name:
          title: Workflow Run Name
          type: string
      required:
        - status
        - workflow_run_id
        - workflow_run_name
      title: TriggerCallResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    LabsAuth:
      description: >-
        Bandwidth Labs OAuth access token. Uses the user's selected workspace;
        the workspace header is not required. Do not also send an API key.
        Bearer-only operations may additionally require the Labs `super_user`
        role.
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.