> For the complete documentation index, see [llms.txt](https://docs.onum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onum.com/the-workspace/pipelines/actions/transformation/field-transformation/field-transformation-operations/conversion/integer-to-uuid.md).

# Integer to UUID

## Description

This operation takes an integer value and converts it to a standard UUID format. The integer must be within the valid range for UUIDs (`0` to `2^128 - 1`).

UUIDs are 128-bit identifiers that are generated to be unique, typically represented as 32 hexadecimal digits, displayed in 5 groups separated by hyphens.

***

## Data types

These are the input/output expected data types for this operation:

### Input data

<img src="/files/5znsr6RzLbBq94l3YqFM" alt="" data-size="line"> - String representing the integer value to be converted into UUID format.&#x20;

Note that integers must be within the valid range for UUIDs (`0` to `2^128 - 1`). You must provide values as strings in order to handle large values.

### Output data

<img src="/files/nzT4DU1eXyG0iQaH0vRi" alt="" data-size="line"> - Representation of the input integer value in standard UUID format (`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`).&#x20;

Output UUID values will be always in lowercase hexadecimal characters and padded with leading zeros to keep 32 hex characters.

***

## Example

Suppose you want to **transform** a series of **integer values** into their corresponding **UUID** identifiers. To do it:

1. In your Pipeline, open the required [Action](/the-workspace/pipelines/actions.md) configuration and select the input **Field**.
2. In the **Operation** field, choose **Integer to UUID**.
3. Give your **Output field** a name and click **Save**. The values in your input field will be transformed. For example:

```
Input data - "20583658"

Output data - "00000000-0000-0000-0000-0000013a14ea"
```

{% hint style="info" %}
You can try out operations with specific values using the **Input** field above the operation. You can enter the value in the example above and check the result in the **Output** field.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onum.com/the-workspace/pipelines/actions/transformation/field-transformation/field-transformation-operations/conversion/integer-to-uuid.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.