---
title: "Create new `costlimit` object"
method: POST
path: "/v1/costlimits"
tags: ["costlimits"]
---

# Create new \`costlimit\` object

`POST /v1/costlimits`

Create new `costlimit` object

## Request body

- LimitInput — Inputs for creating a Limit
  - `warningLevel` number, float — At which percentage does this limit send a warning? (default
  - `units` string — Whether limits acts on minutes or dollars
  - `startDate` string, date — When does this limit start?
  - `recurring` boolean — Whether this cost limit will reset itself after the time period has elapsed
  - `propertyValue` string — Metadata value to limit
  - `propertyType` string — Type of property to limit (account, project, job, metadata)
  - `propertyKey` string — ID of the entity or the Metadata key to limit
  - `limit` number, float — Amount of the limit
  - `endDate` string, date — When does this limit stop?
  - `criticalLevel` number, float — At which percentage does this limit send its final critical notification?
  - `applyAll` boolean — Whether to apply this to all of that entity type (jobs only right now)
  - `action` string — What to do when the limit is breached (send email, prevent further executions, kill instances)

## Response `200`

Successful response

## Other responses

- `400` — Invalid input

---

[API](https://skmtc.dev/conductortech/apis/conductor-cloud-rendering-api.md) · [All operations](https://skmtc.dev/conductortech/apis/conductor-cloud-rendering-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conductortech/conductor-cloud-rendering-api/revisions/0fb056b8d2a1/schema)