> ## 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.

# Answer agent question

> Reply to a question an agent asked.



## OpenAPI

````yaml POST /pending-actions/{actionId}/answer
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}/answer:
    post:
      tags:
        - approvals
      summary: Answer agent question
      description: >-
        Answer a question the agent asked (a pending action whose decision is
        'answer_question'). Read the question and any options with
        get_pending_action first. When the agent asked several questions in one
        run it resumes after the last one is answered or dismissed. Fails while
        the agent is still working on the task.
      operationId: answer_agent_question
      parameters:
        - name: actionId
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 64
            description: Pending action id from list_pending_actions.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                answer:
                  type: string
                  minLength: 1
                  maxLength: 10000
                  description: Your answer, or the chosen option's text.
              required:
                - answer
      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:
            - approvals:write
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.