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

# /2026-01/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}

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

## Request

- Base URL: `https://api.criteo.com`
- URL: `https://api.criteo.com/2026-01/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}`
- 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/:budgetId/patch.ts> (a function with typed inputs; its response is checked against the schema)

Modify an existing active budget to change its limitations or status.
All three types of budgets can be modified.
            
See the additional restrictions listed in the PATCH budgets endpoint.

## Path parameters

- `budgetId` string, int64, required

## Request body

- UpdateSellerBudgetMessageBase: Base data used to update a seller's budget
  - `amount` string
  - `campaignIds` integer[]
  - `endDate` string
  - `isSuspended` boolean
  - `startDate` string, date-time

## Response `200`

Success

- SellerBudgetMessage: A budget defines spending constraints for a seller across one or more campaigns. Each seller can have one active budget per time period.
  - `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)