---
title: "Creates an idempotence identifier"
method: POST
path: "/idempotence_identifiers"
tags: ["idempotence_identifiers"]
---

# Creates an idempotence identifier

`POST /idempotence_identifiers`

The idempotence_identifiers API allows users to generate an idempotent UUID with a user-provided identifier. The idempotent UUIDs can later be passed in POST requests. By default, Nutanix v3 APIs do not allow for operations to be created with user-provided UUIDs; each POST request received by the API gateway results in a UUID4 being automatically generated and returned in the response JSON.

## Request body

- IdempotenceIdentifiersInput — Resources for the idempotence identifier kind.
  - `client_identifier` string — The client identifier string.
  - `count` integer, required — The number of idempotence identifiers provided.
  - `valid_duration_in_minutes` integer — Number of minutes from creation time for which idempotence identifier uuid list is valid.

## Response `200`

Success

- IdempotenceIdentifiersResponse — Idempotence identifier status definition.
  - `client_identifier` string — The client identifier string.
  - `count` integer, required — The number of idempotence identifiers provided.
  - `expiration_time` string, date-time — The expiration time (with reference to system time). Value is creation time + valid_duration
  - `uuid_list` string[], required

## Other responses

- `default` — Internal Error

---

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