---
title: "Update execution policy"
method: PUT
path: "/v1/trader/policy"
tags: ["Trades"]
---

# Update execution policy

`PUT /v1/trader/policy`

## Request

- Base URL: `https://api.marketintell.ai`
- URL: `https://api.marketintell.ai/v1/trader/policy`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Upsert the calling key's execution policy. Controls all safe-execution risk gates, so requires `trade` scope (broker must be connected first).

## Request body

- object
  - `mode` 'review' | 'auto'
  - `max_risk_per_trade_bps` integer
  - `daily_loss_limit_bps` integer
  - `max_concurrent_positions` integer
  - `symbol_whitelist` string[]
  - `max_notional_per_trade_cents` integer
  - `manual_approvals_required` integer
  - `paused` boolean
  - `pause_reason` string

## Response `200`

Updated execution policy

- object
  - `success` boolean
  - `data` object
    - `policy` object

## Other responses

- `400`: Invalid policy body

---

[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)