Generate unique identifiers
Version 4 for randomness, version 7 if you want them to sort by time, in whatever quantity you need.
What it does
Also called: generate a uuid · make a random unique id · bulk generate guids.
Use it from your own code
The same endpoint this page calls — no daily cap, 1 credit a call either way.
POST /v1/core/uuid-generate
curl -X POST "$DOATHING_API/v1/core/uuid-generate" \
-H "x-api-key: $DOATHING_KEY" \
-H "content-type: application/json" \
-d '{"options": {"version": 7, "count": 3}}'
Version 4 for randomness, version 7 if you want them to sort by time, in whatever quantity you need.
Generate UUID v1, v4, v5 or v7 identifiers in bulk, with optional hyphen stripping.
Response
The result carries your remaining balance alongside it, so you can track spend without a second call.
{
"uuids": [
"0193f2…",
"0193f2…",
"0193f2…"
],
"version": 7,
"count": 3,
"request_id": "37f01edb-0163-42a1-ac51-0acaef979800",
"credits_remaining": 96
}
Cost
1 credit per call, whether it is run from the site or from the API — the credential differs, the price does not. A new account starts with 20 credits.
A rejected request still costs a credit: the authorizer decrements before the tool validates. A call rejected for a missing or invalid key is free.
Parameters
Generated from the endpoint’s own validation, so this is exactly what it accepts. A body field goes at the top level; an option goes inside options.
| Name | In | Type | Default | Notes |
|---|---|---|---|---|
| name | body | string | — | |
| namespace | options | string | "dns" | For version 5: dns, url, oid or x500. one of dns, url, oid, x500 |
| hyphens | options | boolean | true | Include the hyphens. |
| uppercase | options | boolean | false | Return uppercase hex. |
| version | options | integer | 4 | 1, 4, 5 or 7. 1 to 7 |
| count | options | integer | 1 | How many to generate, up to 1000. 1 to 1000 |