update_target
Change a target on an Amazon Ads account, behind caps, a dry run and undo.
On this page
Endpoint
Change a target on an Amazon Ads account, behind caps, a dry run and undo.
The call shape is illustrative until the contract is final.
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 | Description |
|---|---|---|
| accountRequired | string | 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.
{ "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.
{ "error": "rate_limited", "retry": 12, "upgrade": "https://build.sellermate.ai/pricing" }
Platforms
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.
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.
Last updated 30 Oct 2026