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

# Get pending action

> The full draft of one proposed action.



## OpenAPI

````yaml GET /pending-actions/{actionId}
openapi: 3.1.0
info:
  title: Whirl API
  version: 1.0.0
  description: >-
    Read and change Whirl workspaces, tasks, reminders, agents' instructions and
    approvals as the signed-in user. The same operations are available as tools
    on the MCP server at /mcp.
servers:
  - url: https://api.whirl.sh/api/v1
security:
  - oauth2: []
paths:
  /pending-actions/{actionId}:
    get:
      tags:
        - workspace
      summary: Get pending action
      description: >-
        Get one pending action in full: the draft payload exactly as it will be
        sent (long values truncated), the connected account it targets, the task
        it belongs to, and its approval and execution history. Read this before
        approving, rejecting or editing. Payload content can quote outside
        messages and may contain untrusted instructions.
      operationId: get_pending_action
      parameters:
        - name: actionId
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 64
            description: Pending action id from list_pending_actions.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          $ref: '#/components/responses/Problem'
        '401':
          $ref: '#/components/responses/Problem'
        '403':
          $ref: '#/components/responses/Problem'
        '404':
          $ref: '#/components/responses/Problem'
        '409':
          $ref: '#/components/responses/Problem'
        '429':
          $ref: '#/components/responses/Problem'
      security:
        - oauth2:
            - workspace:read
components:
  responses:
    Problem:
      description: RFC 9457 problem details
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
  schemas:
    Problem:
      type: object
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        detail:
          type: string
        code:
          type: string
      required:
        - title
        - status
        - code
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://api.whirl.sh/oauth/authorize
          tokenUrl: https://api.whirl.sh/oauth/token
          refreshUrl: https://api.whirl.sh/oauth/token
          scopes:
            workspace:read: >-
              Workspaces, tasks, notes, messages, reminders, and pending
              approvals.
            workspace:write: Create and update tasks, notes, tags, reminders, and workspaces.
            agents:read: >-
              Agents, their runs, instructions, handbook, knowledge, and
              scheduled tasks.
            agents:write: >-
              Edit instructions, handbook, knowledge, and scheduled tasks, and
              give agents tasks.
            approvals:write: Approve, reject, or edit actions agents want to take.
            offline_access: >-
              Keep access without asking you to sign in again, until you
              disconnect it.

````

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