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

# List pending client tool calls

> Returns a workspace-scoped work queue of pending client-executed tool calls. The v1 endpoint only accepts `status=pending`; use the cursor to continue scanning by wait creation time.




## OpenAPI

````yaml /openapi/platform.v1.json get /v1/tool-calls
openapi: 3.0.3
info:
  description: Public platform API for catalog and proxied data-plane routes.
  title: Matrices Platform API
  version: v1
servers:
  - url: https://api.matrices.com
security: []
tags:
  - description: Authenticated bearer credential context.
    name: auth
    x-group: Auth
  - description: Write-only provider credentials with safe connection metadata.
    name: connections
    x-group: Connections
  - description: Materialized workspace principals and active agent counts.
    name: identities
    x-group: Identities
  - description: Remote MCP server registrations.
    name: toolsets
    x-group: Toolsets
  - description: Named allow-only agent tool permissions.
    name: roles
    x-group: Roles
  - description: Client-executed tool calls.
    name: tools
    x-group: Tools
  - description: Reusable agent behavior profiles.
    name: profiles
    x-group: Profiles
  - description: Workspace-owned agent identities.
    name: agents
    x-group: Agents
  - description: Immutable private image inputs.
    name: images
    x-group: Images
  - description: Public model catalog.
    name: models
    x-group: Models
  - description: Running agent threads.
    name: threads
    x-group: Threads
  - description: Agent schedules.
    name: schedules
    x-group: Schedules
  - description: Workspace append-only feeds.
    name: feeds
    x-group: Feeds
  - description: Agent subscriptions over workspace feeds.
    name: subscriptions
    x-group: Subscriptions
  - description: Agent-private and workspace-shared durable memory notes.
    name: memory
    x-group: Memory
  - description: Thread messages.
    name: messages
    x-group: Messages
  - description: Thread event log data.
    name: events
    x-group: Events
  - description: Runtime hook audit and wait resolution.
    name: hooks
    x-group: Hooks
paths:
  /v1/tool-calls:
    get:
      tags:
        - tools
      summary: List pending client tool calls
      description: >
        Returns a workspace-scoped work queue of pending client-executed tool
        calls. The v1 endpoint only accepts `status=pending`; use the cursor to
        continue scanning by wait creation time.
      operationId: ListPendingToolCalls
      parameters:
        - in: query
          name: status
          required: true
          schema:
            enum:
              - pending
            type: string
        - in: query
          name: agentId
          required: false
          schema:
            type: string
        - in: query
          name: toolsetId
          required: false
          schema:
            type: string
        - in: query
          name: threadId
          required: false
          schema:
            type: string
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/Cursor'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PendingToolCallPage'
          description: Pending client tool-call page.
        '400':
          $ref: '#/components/responses/BadRequest'
        '503':
          $ref: '#/components/responses/RuntimeUnavailable'
      security:
        - APIKeyBearer: []
components:
  parameters:
    Limit:
      in: query
      name: limit
      required: false
      schema:
        maximum: 200
        minimum: 1
        type: integer
    Cursor:
      in: query
      name: cursor
      required: false
      schema:
        type: string
  schemas:
    PendingToolCallPage:
      properties:
        nextCursor:
          type: string
        toolCalls:
          items:
            $ref: '#/components/schemas/PendingToolCall'
          type: array
      required:
        - toolCalls
      type: object
    PendingToolCall:
      properties:
        agentId:
          type: string
        createdAt:
          format: date-time
          type: string
        expiresAt:
          format: date-time
          type: string
        input:
          $ref: '#/components/schemas/JSONValue'
        name:
          type: string
        threadId:
          type: string
        toolCallId:
          type: string
        toolsetId:
          type: string
        turnId:
          type: string
        waitId:
          type: string
      required:
        - threadId
        - turnId
        - toolCallId
        - waitId
        - agentId
        - name
        - input
        - createdAt
      type: object
    ErrorResponse:
      properties:
        attemptsRemaining:
          type: integer
        code:
          type: string
        error:
          type: string
        message:
          type: string
        retryAfterSeconds:
          type: integer
      required:
        - error
        - message
      type: object
    JSONValue:
      description: Arbitrary JSON value.
  responses:
    BadRequest:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Invalid request.
    RuntimeUnavailable:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Runtime environment is unavailable or cannot be selected.
  securitySchemes:
    APIKeyBearer:
      scheme: bearer
      type: http

````

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