---
title: "Submit Task Decisions"
method: POST
path: "/v1/ai/agents/tasks/{taskId}/decisions"
tags: ["AI Agent Tasks"]
---

# Submit Task Decisions

`POST /v1/ai/agents/tasks/{taskId}/decisions`

Submits approval or question-answer decisions for a task that is awaiting human input.

## Path parameters

- `taskId` string, uuid, required

## Request body

- TaskDecisionsRequest
  - `decisions` union[], required
    - union
      - QuestionAnswerDecision
        - `type` string, required
        - `answers` QuestionAnswer[], required — The answers to the questions posed by the agent
          - `questionIndex` integer — The zero-based index of the question being answered
          - `selectedOptions` string[], required — The selected option values for the question
        - `id` string, uuid, required — The unique identifier of the question decision
      - ToolApprovalDecision
        - `type` string, required
        - `approved` boolean, required — Whether to approve the tool invocation
        - `id` string, uuid, required — The unique identifier of the tool invocation to approve or deny
        - `scope` 'ONCE' | 'CONVERSATION', nullable — The scope of the approval — ONCE for a single invocation, CONVERSATION for the entire task

## Response `202`

Decisions submitted successfully

- ProcessApprovalsResponse
  - `pendingDecisions` PendingPermission[] — The list of decisions still pending after processing
    - `permissionMessage` PermissionMessage
      - `body` string — A detailed description of the permission being requested
      - `title` string — A short title summarising the permission request
    - `toolId` string — The unique identifier of the tool invocation
    - `toolInput` unknown
    - `toolName` string — The name of the tool requesting permission
    - `type` 'tool' | 'question' — The type of decision required

## Other responses

- `400` — Invalid request body
- `401` — Missing or invalid authentication token
- `403` — Insufficient permissions
- `404` — Task not found
- `502` — Upstream service error
- `504` — Upstream service timeout

---

[API](https://skmtc.net/maia/apis/maia-public-rest-api.md) · [All operations](https://skmtc.net/maia/apis/maia-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia/maia-public-rest-api/versions/6239825f68eb/schema)