---
title: "Submit Approvals"
method: POST
path: "/workspaces/{workspace_id}/approvals/{session_id}"
tags: ["approvals"]
---

# Submit Approvals

`POST /workspaces/{workspace_id}/approvals/{session_id}`

## Request

- Base URL: `https://platform.tracecat.com/api`
- URL: `https://platform.tracecat.com/api/workspaces/{workspace_id}/approvals/{session_id}`
- Auth: API key in cookie `fastapiusersauth`

Submit approval decisions to a running agent workflow.

This endpoint sends approval decisions back to an agent workflow
that is waiting for human-in-the-loop approval on tool calls.

Args:
    role: The authenticated user role.
    session_id: The agent session ID (used to lookup the workflow).
    payload: The approval decisions mapping tool_call_id to decision.
    session: Database session for workspace-scoped lookups.

Raises:
    HTTPException 400: If the approval submission fails validation.
    HTTPException 404: If the agent session/workflow is not found.
    HTTPException 500: For unexpected errors.

## Path parameters

- `session_id` string, uuid, required
- `workspace_id` string, uuid, required

## Request body

- ApprovalSubmission: Request model for submitting approval decisions.
  - `approvals` ApprovalMap, required

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tracecat/apis/tracecat-api.md) - [All operations](https://skmtc.dev/tracecat/apis/tracecat-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tracecat/apis/tracecat-api/revisions/2efdda25045f?raw)