POST text

uuid_generate

1 credit

Generate a UUID. Version 4 produces a random UUID. Version 5 produces a deterministic UUID from a namespace and name.

Endpoint

POST /api/v1/tools/text/uuid_generate

Body Parameters

name string | null optional default: null

version integer optional default: 4

Options: 4 5

namespace string | null optional default: null

Example

input Request

{
    "name": "example.com",
    "version": 5,
    "namespace": "dns"
}

output Response

{
    "uuid": "cfbff0d1-9375-5685-968c-48ce8b15ae17",
    "version": 5
}

Response Format

HTTP/1.1 200 OK SUCCESS

{
  "success": true,
  "data": {
    "uuid": "cfbff0d1-9375-5685-968c-48ce8b15ae17",
    "version": 5
},
  "meta": {
    "tool": "uuid_generate",
    "credits_consumed": 1
  }
}

HTTP/1.1 422 Unprocessable Entity ERROR

{
  "success": false,
  "data": null,
  "error": {
    "code": "validation_error",
    "message": "The given data was invalid."
  }
}

Code Examples

Request Example

lightbulb Developer Tip

Credits are deducted before execution. If the upstream tool fails, credits are automatically refunded to your account.