---
title: "/2026-01/marketing-solutions/marketplace-performance-outcomes/budgets"
method: PATCH
path: "/2026-01/marketing-solutions/marketplace-performance-outcomes/budgets"
tags: ["Campaign"]
---

# /2026-01/marketing-solutions/marketplace-performance-outcomes/budgets

`PATCH /2026-01/marketing-solutions/marketplace-performance-outcomes/budgets`

Modify one or more existing active budgets to change their limitations or status.
All three types of budgets can be modified.
            
The following constraints apply when modifying an existing budget.
            
• <b>campaignIds</b>: a non-empty subset of the original campaign ids MAY be supplied<br />
• <b>amount</b>: an amount MAY be supplied only if the type is not Uncapped and if supplied it MUST be non-negative<br />
• <b>startDate</b>: a future start date MAY be supplied for budgets that have not yet started<br />
• <b>endDate</b>: an end date MAY be supplied and if supplied MUST be a future date greater than the start date<br />
            
Other attributes MUST NOT be supplied.
            
Adding new campaigns to a budget is not allowed. In addition, reducing the amount for
a Capped budget to a value less than the current spend not allowed.

## Request body

- UpdateSellerBudgetMessage[]
  - `amount` string
  - `budgetId` integer
  - `campaignIds` integer[]
  - `endDate` string
  - `isSuspended` boolean
  - `startDate` string, date-time

## Response `200`

Success

- SellerBudgetMessage[]
  - `amount` number, double, nullable — Budget amount in the advertiser's currency
  - `budgetType` string — Type of budget: 'Daily' (daily cap), 'Capped' (lifetime with fixed amount), or 'Uncapped' (lifetime with no limit)
  - `campaignIds` integer[] — List of campaign IDs this budget applies to
  - `endDate` string — End date of the budget period (format: YYYY-MM-DD), or empty string if open-ended
  - `id` string — Unique budget identifier
  - `isSuspended` boolean — Whether the budget has been manually suspended by the partner
  - `sellerId` string — Identifier of the seller this budget belongs to
  - `spend` number, double, nullable — Amount spent against this budget so far, or null if not available
  - `startDate` string, date — Start date of the budget period (format: YYYY-MM-DD)
  - `status` 'Archived' | 'Current' | 'Scheduled' — Status of a seller budget

---

[API](https://skmtc.net/criteo/apis/criteo-api.md) · [All operations](https://skmtc.net/criteo/apis/criteo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/criteo/criteo-api/revisions/c1721589426a/schema)