> ## Documentation Index > Fetch the complete documentation index at: https://developers.datagrid.com/llms.txt > Use this file to discover all available pages before exploring further. # List voice orchestrator tasks > List delegated voice tasks for the authenticated user. By default this returns active, non-expired queued or running tasks plus unacknowledged terminal tasks and omits task result content from list views. Pass an explicit status filter to request a specific task state. A `cancelled` status marks tasks stopped via the cancel endpoint (`PATCH /voice-orchestrator/tasks/{task_id}/cancel`). ## OpenAPI ````yaml get /voice-orchestrator/tasks openapi: 3.0.3 info: version: 0.1.1 title: Datagrid API description: Datagrid API servers: - url: https://api.datagrid.com/v1 security: - BearerAuth: [] paths: /voice-orchestrator/tasks: get: tags: - Voice summary: List voice orchestrator tasks description: | List delegated voice tasks for the authenticated user. By default this returns active, non-expired queued or running tasks plus unacknowledged terminal tasks and omits task result content from list views. Pass an explicit status filter to request a specific task state. A `cancelled` status marks tasks stopped via the cancel endpoint (`PATCH /voice-orchestrator/tasks/{task_id}/cancel`). operationId: VoiceOrchestratorTasks.list parameters: - name: conversation_id in: query required: false schema: type: string - name: status in: query required: false style: form explode: true schema: type: array items: type: string description: >- Status filter. Repeat the parameter for multiple statuses (`?status=queued&status=running`); comma-separated values are also accepted. Supported values: queued, running, completed, failed, cancelled. - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 25 responses: '200': description: Voice orchestrator tasks content: application/json: schema: $ref: '#/components/schemas/VoiceOrchestratorTaskList' '400': description: Invalid status or limit query parameter. content: application/json: schema: $ref: '#/components/schemas/VoiceOrchestratorTaskError' '401': description: >- Unauthorized. Authentication is required to list voice orchestrator tasks. content: application/json: schema: $ref: '#/components/schemas/VoiceOrchestratorTaskError' '403': description: >- Forbidden. The API key or user lacks the required voice read endpoint scope or resource permission. content: application/json: schema: $ref: '#/components/schemas/VoiceOrchestratorTaskError' '404': description: Voice task status is not enabled for this teamspace. content: application/json: schema: $ref: '#/components/schemas/VoiceOrchestratorTaskError' '429': description: >- Rate limit exceeded. The request has been throttled because the rate limit for this endpoint has been reached. content: application/json: schema: $ref: '#/components/schemas/RateLimitError' components: schemas: VoiceOrchestratorTaskList: type: object required: - object - data - has_more - first_id - last_id properties: object: type: string enum: - list data: type: array items: $ref: '#/components/schemas/VoiceOrchestratorTask' has_more: type: boolean description: Always false for the bounded voice task inbox. first_id: type: string nullable: true description: >- The first task ID in this bounded list response, or null when the list is empty. last_id: type: string nullable: true description: >- The last task ID in this bounded list response, or null when the list is empty. VoiceOrchestratorTaskError: type: object required: - message properties: message: oneOf: - type: string - type: array items: type: string description: Human-readable error message. error: type: string description: HTTP error summary when provided by the server. RateLimitError: type: object description: >- Returned when the rate limit is exceeded. Rate limits are enforced per teamspace, endpoint path, and HTTP method over a 60-second sliding window. Each endpoint may have its own limit — check the X-RateLimit-Limit response header for the effective value. required: - error - message - retryable - status_code properties: status_code: type: integer description: The HTTP status code (429). statusCode: type: integer deprecated: true description: Deprecated. Use status_code instead. error: type: string enum: - rate_limit_exceeded description: The error code identifying this as a rate limit error. message: type: string description: A human-readable error message. mitigation: type: string description: Suggested action to resolve the error. retryable: type: boolean description: Whether the request can be retried after a delay. details: type: object properties: reason: type: string description: A detailed explanation of why the rate limit was exceeded. VoiceOrchestratorTask: type: object required: - task_id - status - task - expires_at - created_at - updated_at properties: task_id: type: string conversation_id: type: string agent_id: type: string parent_task_id: type: string description: >- Present when this task was created by follow_up_task to continue an earlier delegated task. status: type: string description: >- `cancelled` is reserved for terminal task records produced by future cancellation flows; this API does not currently expose a cancel operation. enum: - queued - running - completed - failed - cancelled task: type: string result: type: string description: >- Present on retrieve responses when a user-owned task has a result. Omitted from list responses. error_message: type: string acknowledged_at: type: string format: date-time expires_at: type: string format: date-time created_at: type: string format: date-time updated_at: type: string format: date-time completed_at: type: string format: date-time pending_action: type: object description: >- Present on retrieve responses when the delegated agent halted on an approval-required action that is still awaiting user review. Omitted from list responses and once the action has been submitted. required: - payload_id - action_name - agent_explanation properties: payload_id: type: string tool_id: type: string action_name: type: string agent_explanation: type: string submit_button_text: type: string connector_id: type: string securitySchemes: BearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.