---
title: "POST /2023-10-12/farms/{farmId}/budgets"
method: POST
path: "/2023-10-12/farms/{farmId}/budgets"
---

# POST /2023-10-12/farms/{farmId}/budgets

`POST /2023-10-12/farms/{farmId}/budgets`

Creates a budget to set spending thresholds for your rendering activity.

## Path parameters

- `farmId` string, required

## Headers

- `X-Amz-Client-Token` string

## Request body

- object
  - `displayName` string, required — <p>The display name of the budget.</p> <important> <p>This field can store any content. Escape or encode this content before displaying it on a webpage or any other system that might interpret the content of this field.</p> </important>
  - `description` string, password — <p>The description of the budget.</p> <important> <p>This field can store any content. Escape or encode this content before displaying it on a webpage or any other system that might interpret the content of this field.</p> </important>
  - `usageTrackingResource` object, required — The usage details of the allotted budget.
    - `queueId` string — The queue ID.
  - `approximateDollarLimit` number, float, required — The dollar limit based on consumed usage.
  - `actions` BudgetActionToAdd[], required — The budget actions to specify what happens when the budget runs out.
    - `type` 'STOP_SCHEDULING_AND_COMPLETE_TASKS' | 'STOP_SCHEDULING_AND_CANCEL_TASKS', required — The type of budget action to add.
    - `thresholdPercentage` number, float, required — The percentage threshold for the budget action to add.
    - `description` string, password — <p>A description for the budget action to add.</p> <important> <p>This field can store any content. Escape or encode this content before displaying it on a webpage or any other system that might interpret the content of this field.</p> </important>
  - `schedule` object, required — The start and end time of the budget.
    - `fixed` object — The fixed start and end time of the budget's schedule.
      - `startTime` string, date-time, required — When the budget starts.
      - `endTime` string, date-time, required — When the budget ends.
  - `tags` object — Each tag consists of a tag key and a tag value. Tag keys and values are both required, but tag values can be empty strings.

## Response `200`

Success

- CreateBudgetResponse — Mixin that adds an optional ARN field to response structures. Apply to SummaryMixins (flows into Get, Summary, and BatchGet) and Create outputs.
  - `budgetId` string, required — The budget ID.

## Other responses

- `480` — AccessDeniedException
- `481` — InternalServerErrorException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — ValidationException
- `485` — ServiceQuotaExceededException

---

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