> ## Documentation Index
> Fetch the complete documentation index at: https://developers.criteo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# /2025-07/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}

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



## OpenAPI

````yaml https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json patch /2025-07/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}
openapi: 3.0.1
info:
  title: Criteo API
  description: Criteo API - MarketingSolutions
  version: 2025-07
servers:
  - url: https://api.criteo.com
security:
  - oauth: []
tags:
  - name: Advertiser
  - name: Analytics
  - name: Audience
  - name: Campaign
  - name: Creative
  - name: Gateway
paths:
  /2025-07/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}:
    patch:
      tags:
        - Campaign
      summary: >-
        /2025-07/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}
      description: "Modify an existing active budget to change its limitations or status.\r\nAll three types of budgets can be modified.\r\n            \r\nSee the additional restrictions listed in the PATCH budgets endpoint."
      operationId: UpdateMarketplaceSellerBudget
      parameters:
        - name: budgetId
          in: path
          description: Id of the budget
          required: true
          schema:
            type: string
            format: int64
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateSellerBudgetMessageBase'
        required: true
        x-bodyName: message
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SellerBudgetMessage'
      security:
        - oauth:
            - MarketingSolutions_Campaign_Manage
components:
  schemas:
    UpdateSellerBudgetMessageBase:
      type: object
      properties:
        amount:
          type: string
        campaignIds:
          type: array
          items:
            type: integer
            format: int32
        endDate:
          type: string
        isSuspended:
          type: boolean
        startDate:
          type: string
          format: date-time
      description: Base data used to update a seller's budget
    SellerBudgetMessage:
      type: object
      properties:
        amount:
          type: number
          description: Budget amount in the advertiser's currency
          format: double
          nullable: true
        budgetType:
          type: string
          description: >-
            Type of budget: 'Daily' (daily cap), 'Capped' (lifetime with fixed
            amount), or 'Uncapped' (lifetime with no limit)
        campaignIds:
          type: array
          items:
            type: integer
            format: int32
          description: List of campaign IDs this budget applies to
        endDate:
          type: string
          description: >-
            End date of the budget period (format: YYYY-MM-DD), or empty string
            if open-ended
        id:
          type: string
          description: Unique budget identifier
        isSuspended:
          type: boolean
          description: Whether the budget has been manually suspended by the partner
        sellerId:
          type: string
          description: Identifier of the seller this budget belongs to
        spend:
          type: number
          description: Amount spent against this budget so far, or null if not available
          format: double
          nullable: true
        startDate:
          type: string
          description: 'Start date of the budget period (format: YYYY-MM-DD)'
          format: date
        status:
          $ref: '#/components/schemas/SellerBudgetStatusV2'
      description: >-
        A budget defines spending constraints for a seller across one or more
        campaigns. Each seller can have one active budget per time period.
      example:
        id: '16501666'
        sellerId: '10656107'
        campaignIds:
          - 436017
        budgetType: Capped
        amount: 462.47
        endDate: '2026-04-30'
        spend: 117.59
        status: Current
        isSuspended: false
    SellerBudgetStatusV2:
      enum:
        - Archived
        - Current
        - Scheduled
      type: string
      description: Status of a seller budget
  securitySchemes:
    oauth:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes: {}
        authorizationCode:
          authorizationUrl: https://api.criteo.com/oauth2
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes: {}

````