---
title: Update a Budget Order
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/put-shared-budgets-_id_
---

# Update a Budget Order

Updates mutable fields of an existing budget order by its unique identifier.

## URL

PUT https://api.ads.apple.com/v1/shared-budgets/{id}

## Path Parameters

id:

## Response Codes

200 OK: Successful operation. Returns SharedBudgetResponse (result: SharedBudget). 400 Bad Request: Bad Request. Returns ErrorResponse. 401 Unauthorized: Unauthorized. 403 Forbidden: Forbidden. 404 Not Found: Resource not found. Returns ErrorResponse. 429 Too Many Requests: Rate Limit Exceeded. See Applying Rate Limits. 500 Internal Server Error: Internal Server Error. Returns ErrorResponse.

## Discussion

Discussion This endpoint updates one or more mutable fields on an existing budget order. Only include the fields you want to change. Fields you don’t include remain unchanged. Pass the budget order id as a URL path parameter. You don’t need to include it in the request body. End date changes on active budget orders can only shorten the period, not extend it, except that you can set endTime to null to remove the expiration date entirely and make the budget open-ended. Payload Examples

## See Also

- [Get a Budget Order by ID](apple-ads-platform-api/get-shared-budgets-_id_.md)
- [Create a Budget Order](apple-ads-platform-api/post-shared-budgets.md)
- [Query Budget Orders](apple-ads-platform-api/post-shared-budgets-query.md)
- [Delete a Budget Order](apple-ads-platform-api/delete-shared-budgets-_id_.md)