---
title: "New Tag"
method: POST
path: "/tag/new"
tags: ["tag management"]
---

# New Tag

`POST /tag/new`

Create a new tag.

Parameters:
- name: str - The name of the tag
- description: Optional[str] - Description of what this tag represents
- models: List[str] - List of either 'model_id' or 'model_name' allowed for this tag
- budget_id: Optional[str] - The id for a budget (tpm/rpm/max budget) for the tag

### IF NO BUDGET ID - CREATE ONE WITH THESE PARAMS ###
- max_budget: Optional[float] - Max budget for tag
- tpm_limit: Optional[int] - Max tpm limit for tag
- rpm_limit: Optional[int] - Max rpm limit for tag
- max_parallel_requests: Optional[int] - Max parallel requests for tag
- soft_budget: Optional[float] - Get a slack alert when this soft budget is reached
- model_max_budget: Optional[dict] - Max budget for a specific model
- budget_duration: Optional[str] - Frequency of resetting tag budget

## Request body

- TagNewRequest
  - `name` string, required
  - `description` string, nullable
  - `models` string[], nullable
  - `model_info` object, nullable
  - `budget_id` string, nullable
  - `max_budget` number, nullable
  - `soft_budget` number, nullable
  - `max_parallel_requests` integer, nullable
  - `tpm_limit` integer, nullable
  - `rpm_limit` integer, nullable
  - `model_max_budget` object, nullable
  - `budget_duration` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.net/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sea-lion/litellm-api/revisions/1e929292ddd5/schema)