---
title: "Remove a cost threshold"
method: DELETE
path: "/v1/cost-thresholds"
tags: ["Cost Thresholds"]
---

# Remove a cost threshold

`DELETE /v1/cost-thresholds`

## Request

- Base URL: `https://api.telgea.com`
- URL: `https://api.telgea.com/v1/cost-thresholds`
- Auth: API key in header `x-api-key`

Ends the scope's threshold on a usage type now: the organization's (no team or user), a team's (`teamId`) or a user's own (`userId`). A user then falls under their team's threshold, a team under the organization's; with none left, the usage is unlimited.

Removing a threshold that is not set changes nothing and still answers `204`.

**Scope:** `policies:write`, and `teams:read` when a team is named.

## Query parameters

- `usageType` 'DATA' | 'VOICE' | 'SMS' | 'MMS', required: The usage type the threshold is on. `VOICE` is international calling: reaching it pauses international calls and SMS on the person's lines, where their market offers the pause. Other types answer `422` until the platform can enforce them.
- `teamId` string, uuid: UUID of the team the threshold is for. Omit with `userId` for the organization's own.
- `userId` string, uuid: UUID of the user the threshold is for. Omit with `teamId` for the organization's own.

## Headers

- `idempotency-key` string: A value unique to this request, of 1 to 255 printable ASCII characters — a UUID is the usual choice. Retry with the same key within 24 hours and you get the original response back, even if it was a failure, and nothing is done twice. Send a new key whenever you change the request. Keys are private to your API key and organisation.

## Response `204`

The threshold is ended, or none was set.

## Other responses

- `400`: Request failed schema validation, or named both a team and a user
- `401`: Missing or invalid API key in the X-API-Key header
- `403`: Insufficient permissions to manage policies
- `404`: No team in your organization has this id, so nothing was read or changed. No user in your organization has this id, so nothing was read or changed.
- `422`: No threshold can stand on this usage type yet, so nothing was read or changed.
- `429`: The API key has used its request quota for the current window. `Retry-After` says how many seconds until it resets.
- `500`: Internal server error. Contact support if this persists.

---

[API](https://skmtc.dev/telgea/apis/telgea-api.md) - [All operations](https://skmtc.dev/telgea/apis/telgea-api/llms.txt) - [OpenAPI document](https://skmtc.dev/telgea/apis/telgea-api/revisions/4e8f8c04fe9e?raw)