---
title: "POST /tag"
method: POST
path: "/tag"
tags: ["tags"]
---

# POST /tag

`POST /tag`

Creates a tag with the given key and value.

## Query parameters

- `tag_key` string
- `tag_value` string
- `admin_owner_id` string, uuid

## Request body

- CreateTagInfo — # CreateTagInfo Object ### Description The `CreateTagInfo` object is used to represent configuration for a new tag. ### Usage Example Use in the `POST Tag` endpoint.
  - `tag_key` string, required — The key of the tag to create.
  - `tag_value` string — The value of the tag to create.

## Response `200`

The tag that was created.

- Tag — # Tag Object ### Description The `Tag` object is used to represent a tag. ### Usage Example Get tags from the `GET Tag` endpoint.
  - `tag_id` string, uuid, required — The ID of the tag.
  - `created_at` string, date-time — The date the tag was created.
  - `updated_at` string, date-time — The date the tag was last updated.
  - `user_creator_id` string, uuid — The ID of the user that created the tag.
  - `key` string — The key of the tag.
  - `value` string — The value of the tag.

---

[API](https://skmtc.net/opal/apis/opal-api.md) · [All operations](https://skmtc.net/opal/apis/opal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opal/opal-api/revisions/13b58df96d40/schema)