# `FireblocksSdk.Api.Tags`
[🔗](https://github.com/csokun/fireblocks_sdk/blob/v0.2.1/lib/fireblocks_sdk/api/tags.ex#L1)

Fireblocks Tags API.

Provides CRUD operations for workspace tags and tag approval request management.
Tags can be attached to vault accounts to organize and group them.

# `cancel_approval_request`
[🔗](https://github.com/csokun/fireblocks_sdk/blob/v0.2.1/lib/fireblocks_sdk/api/tags.ex#L143)

Cancels a pending tag approval request.

Only PENDING approval requests can be cancelled. Returns 202 Accepted on success.

- `id`: Numeric string ID of the approval request to cancel

# `create_tag`
[🔗](https://github.com/csokun/fireblocks_sdk/blob/v0.2.1/lib/fireblocks_sdk/api/tags.ex#L79)

Creates a new tag in the workspace.

Options:
* `:label` (`t:String.t/0`) - Required. The tag label (2–30 characters)

* `:description` (`t:String.t/0`) - Tag description (max 250 characters)

* `:color` (`t:String.t/0`) - Hex color code (e.g. `#FF5733`)

* `:isProtected` (`t:boolean/0`) - Whether the tag is protected from modification by non-owners The default value is `false`.

# `delete_tag`
[🔗](https://github.com/csokun/fireblocks_sdk/blob/v0.2.1/lib/fireblocks_sdk/api/tags.ex#L123)

Deletes a tag from the workspace by its ID.

- `tag_id`: UUID of the tag to delete

# `get_approval_request`
[🔗](https://github.com/csokun/fireblocks_sdk/blob/v0.2.1/lib/fireblocks_sdk/api/tags.ex#L132)

Retrieves a single tag approval request by its numeric ID.

- `id`: Numeric string ID of the approval request

# `get_tag`
[🔗](https://github.com/csokun/fireblocks_sdk/blob/v0.2.1/lib/fireblocks_sdk/api/tags.ex#L90)

Retrieves a single tag by its ID.

- `tag_id`: UUID of the tag to retrieve

# `list_tags`
[🔗](https://github.com/csokun/fireblocks_sdk/blob/v0.2.1/lib/fireblocks_sdk/api/tags.ex#L46)

Returns a paginated list of all tags in the workspace, filtered by optional criteria.

Options:
* `:pageCursor` (`t:String.t/0`) - Page cursor for the next page of results

* `:pageSize` (`t:non_neg_integer/0`) - Number of results per page (1–100, default 100)

* `:label` (`t:String.t/0`) - Filter tags by label prefix

* `:tagIds` (list of `t:String.t/0`) - Filter by specific tag IDs (max 100 UUIDs)

* `:includePendingApprovalsInfo` (`t:boolean/0`) - Include pending approval info in results The default value is `false`.

* `:isProtected` (`t:boolean/0`) - Filter by tag protection status

# `update_tag`
[🔗](https://github.com/csokun/fireblocks_sdk/blob/v0.2.1/lib/fireblocks_sdk/api/tags.ex#L112)

Updates an existing tag's label or description.

- `tag_id`: UUID of the tag to update

Options:
* `:label` (`t:String.t/0`) - The tag label

* `:description` (`t:String.t/0`) - Tag description

---

*Consult [api-reference.md](api-reference.md) for complete listing*