---
title: "Deny a manual approval entry"
method: POST
path: "/approvals/{txId}/deny"
tags: ["Approvals"]
---

# Deny a manual approval entry

`POST /approvals/{txId}/deny`

## Request

- Base URL: `http://localhost:3200`
- URL: `http://localhost:3200/approvals/{txId}/deny`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/steward-fi/apis/steward-api/docs/approvals/:txId/deny/post.ts> (a function with typed inputs; its response is checked against the schema)

Requires an owner/admin browser session with recent MFA. Tenant API keys and agent tokens cannot review or mutate manual approvals. Denial updates the approval and transaction status in one transaction, writes audit events, and dispatches denial webhooks.

## Headers

- `X-Steward-Request-Timestamp` string
- `X-Steward-Request-Expires-At` string
- `X-Steward-Signature` string
- `X-Steward-Signing-Key-Id` string
- `Idempotency-Key` string

## Request body

- object
  - `reason` string, required
  - `deniedBy` string

## Response `200`

JSON response

- object
  - `ok` true, required
  - `data` object, required
    - `id` string, required
    - `txId` string, required
    - `agentId` string, required
    - `agentName` string
    - `status` 'pending' | 'approved' | 'rejected', required
    - `requestedAt` string, date-time, required
    - `resolvedAt` string, date-time, nullable
    - `resolvedBy` string, nullable
    - `toAddress` string, nullable
    - `value` string, nullable
    - `chainId` integer, nullable
    - `txStatus` string, nullable
    - `comment` string
    - `reason` string

## Other responses

- `400`: JSON response
- `401`: JSON response
- `403`: JSON response
- `404`: JSON response
- `408`: JSON response
- `409`: JSON response

## Changes

- **2026-08-17** `261a7c8070b2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/steward-fi/apis/steward-api/changes/approvals/:txId/deny/post.md)

---

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