# update_target

> Change a target on an Amazon Ads account, behind caps, a dry run and undo.

## Endpoint

POST https://build-api.sellermate.ai/v1/tools/update_target — Change a target on an Amazon Ads account, behind caps, a dry run and undo. (writes: yes; platforms: Amazon)

The call shape is illustrative until the contract is final.

> **Amazon only: Writes run on Amazon accounts only**
>
> Caps, a dry run, idempotency keys, a 24 hour undo and an audit log apply. See [Writes and guardrails](https://build.sellermate.ai/docs/guides/writes-and-guardrails.md).

## When to use it

Use it to apply a bid change after your code or a person has approved it. Run a dry run first. It needs a key with the read and write scope.

## Request fields

| Name | Type | Required | Description |
|---|---|---|---|
| `account` | string | yes | The account to read. A key only reaches the accounts you chose when you created it. |

_To write: the other request fields: the target, the new bid or state, the dry-run flag and the idempotency key, with types, limits and examples_

## Response fields

Every answer says how fresh it is with `data_as_of`.

_To write: the response of a dry run and of an applied change, including the log entry id and the undo handle_

## Examples

_To write: a dry-run request and response, then the applied request and response. Show the real field names for the target, the new bid and the dry-run flag_

## Errors

### 422 Unprocessable

A change above a cap is refused and nothing is applied.

```json
{ "status": 422, "message": "bid 2.40 is above this account's ceiling of 2.00." }
```

Lower the bid and send it again.

### 429 Too many requests

You went over the plan's requests per minute. The body says when to retry.

```json
{ "error": "rate_limited", "retry": 12, "upgrade": "https://build.sellermate.ai/pricing" }
```

## Platforms

- Amazon: Reads: yes · Writes: yes

## Open in your AI

Paste this into Claude Code, Cursor, Lovable, n8n or Zapier. It points your AI at the docs and at your key.

Prompt:

```
Read https://build.sellermate.ai/SKILL.md. My key is in BUILD_API_KEY. Use update_target to run a dry run that lowers the bid on target tgt_123 to 2.00, and show me the result before applying it.
```