UUID generate

POST /api/uuid-generate

Generate UUIDs over an HTTP API. v4 (random, the standard choice) or v7 (time-ordered for database-friendly insertion). Bulk generation supported.

Generates UUIDs. Two versions: - `v4` (default): 122 random bits. The standard choice when you just need a unique id. - `v7`: time-ordered. The first 48 bits encode a millisecond timestamp followed by random bits. Inserts into a sorted index in approximate insertion order — much friendlier to B-tree databases than v4. Set `count` for bulk generation. The response always includes both the canonical hyphenated form and a compact unhyphenated form.

Inputs

Name	Type	Default	Description
version	enum (v4 \| v7 \| nil)	"v4"	UUID version.
count	number (1…256)	1	How many UUIDs to emit.

Response

Modes: json. Cache: not cacheable.

Code samples

Built from the single-v4 example.


curl -X POST https://api.xtract.bot/api/uuid-generate \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-Account-Id: $XTRACT_ACCOUNT_ID" \
  -H "X-Api-Key: $XTRACT_API_KEY" \
  -d '{
  "version": "v4",
  "count": 1
}'