---
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`

## Request

- Base URL: `https://api.criteo.com`
- URL: `https://api.criteo.com/2026-01/marketing-solutions/marketplace-performance-outcomes/budgets`
- Auth: OAuth 2
  - Authorization code: `https://api.criteo.com/oauth2`
  - Client credentials
  - Token URL: `https://api.criteo.com/oauth2/token` scopes: `MarketingSolutions_Campaign_Manage`
- TypeScript: <https://skmtc.dev/criteo/apis/criteo-api/docs/2026-01/marketing-solutions/marketplace-performance-outcomes/budgets/patch.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/criteo/apis/criteo-api.md) - [All operations](https://skmtc.dev/criteo/apis/criteo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/criteo/apis/criteo-api/revisions/c1721589426a?raw)