Generate

Generate UUIDs

POST/v1/generate/uuid/{version}

Generates between 1 and 100 version 4 UUIDs, or a single version 1 UUID (time based UUIDs generated in a burst can collide). The body is optional and defaults to one UUID.

Updated October 27, 2026

Parameters

Name	Type	Required	Description
version	one of: v1, v4	yes

Request body

Name	Type	Required	Description
count	integer	no	Number of IDs to generate (1-100) (default `1`)

Example request

A request body that works, as JSON.

{}

Response

The fields inside data of a successful response.

Name	Type	Required	Description
ids	array of string	yes	Generated IDs
type	string	yes	Type of IDs generated
count	integer	yes	Number of IDs generated

Example response

A real answer from the operation, as JSON. The fields in the table above are inside data.

{
  "data": {
    "ids": [
      "c737fba0-d1d6-11f1-be36-65815f19c660"
    ],
    "type": "uuid_v1",
    "count": 1
  },
  "errors": null,
  "meta": {
    "request_id": "f9513326-cd1c-46d8-aff2-50cc6d150a50",
    "timestamp": "2026-10-27T07:19:42.073824Z",
    "version": "2026-03-26"
  },
  "pagination": null
}

Responses

Status	When it happens
200	Successful Response
400	The body respects the operation schema, but the use case rejected it. Each problem is one ApiError entry
413	The request is larger than the request size limit of the API allows
422	The body does not respect the operation schema. Each problem is one ApiError entry with the code validation_error
500	Something failed inside the server and was not an input problem. The same envelope, errors may be empty