---
title: "Reject a trade intent"
method: POST
path: "/v1/trades/{id}/reject"
tags: ["Trades"]
---

# Reject a trade intent

`POST /v1/trades/{id}/reject`

## Request

- Base URL: `https://api.marketintell.ai`
- URL: `https://api.marketintell.ai/v1/trades/{id}/reject`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Reject a pending intent (atomic CAS). Optional `reason`. Requires `trade` scope. 404 if not found or not pending.

## Path parameters

- `id` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `reason` string

## Response `200`

Intent rejected

- object
  - `success` boolean
  - `data` object
    - `rejected` string

## Other responses

- `404`: Not found or not pending

---

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