Browse documentation

Generators API

10 endpoints for generators workflows. Every call requires bearer authentication and uses the standard ToolsOnDuty response envelope.

Try it

Runs a real request from your browser to your own ToolsOnDuty account. Your key is only kept in this page and is never stored.

EndpointAPI key

count

POST/v1/uuid1 credit / call

UUID v4 generator

Generate one or more random UUID v4 values.

Parameter	Type	Required	Description
count	number	No	How many to generate (1-100). Default: 1.

Request

curl -X POST https://toolsonduty.com/api/v1/uuid \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"count":3}'

Response

{
  "ok": true,
  "data": {
    "uuids": [
      "b3b7...",
      "c4d8...",
      "e5f1..."
    ]
  }
}

POST/v1/token1 credit / call

Random token generator

Generate one or more cryptographically random tokens in hex, base62, base64url or alphanumeric.

Parameter	Type	Required	Description
format	string	No	hex \| base62 \| base64url \| alphanumeric. Default: base62.
length	number	No	Token length (1-256). Default: 32.
count	number	No	How many to generate (1-100). Default: 1.
prefix	string	No	Optional prefix prepended to each token.

Request

curl -X POST https://toolsonduty.com/api/v1/token \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"format":"base62","length":24}'

Response

{
  "ok": true,
  "data": {
    "tokens": [
      "aZ9k..."
    ]
  }
}

POST/v1/generators/passphrase1 credit / call

Memorable passphrase generator

Generate a memorable passphrase (e.g. correct-horse-battery-staple) from a curated word list using secure randomness.

Parameter	Type	Required	Description
words	number	No	Number of words (2-12). Default: 4.
separator	string	No	Separator between words. Default: -.
capitalize	boolean	No	Capitalize each word. Default: false.
number	boolean	No	Append a random 2-digit number. Default: false.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/passphrase \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"words":4}'

Response

{
  "ok": true,
  "data": {
    "result": "coral-lantern-otter-brave"
  }
}

POST/v1/generators/ascii-banner1 credit / call

ASCII banner generator

Render text as a large block-letter ASCII banner (5-row font).

Parameter	Type	Required	Description
text	string	Yes	Text to render (max ~40 characters recommended).

Request

curl -X POST https://toolsonduty.com/api/v1/generators/ascii-banner \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"text":"HI"}'

Response

{
  "ok": true,
  "data": {
    "result": "#   #  #####\n#   #    #\n#####    #\n#   #    #\n#   #  #####"
  }
}

POST/v1/generators/mock-data1 credit / call

Mock data generator

Generate an array of mock JSON records with the requested fields: id, firstName, lastName, fullName, email, phone, city, street, company, jobTitle, date, boolean, uuid.

Parameter	Type	Required	Description
fields	string	Yes	Array of field names, e.g. ["firstName","email"]. Allowed: id, firstName, lastName, fullName, email, phone, city, street, company, jobTitle, date, boolean, uuid.
count	number	No	Number of records (1-1000). Default: 10.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/mock-data \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"fields":["firstName","email"],"count":2}'

Response

{
  "ok": true,
  "data": {
    "result": [
      {
        "firstName": "Ada",
        "email": "[email protected]"
      }
    ]
  }
}

POST/v1/generators/deep-link1 credit / call

Mobile deep link builder

Build a custom-scheme deep link URI from a scheme, host, path and query parameters.

Parameter	Type	Required	Description
scheme	string	Yes	URI scheme, e.g. "myapp".
host	string	No	Host segment. Default: .
path	string	No	Path segment. Default: .
params	string	No	Array of {key, value} query parameters.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/deep-link \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"scheme":"myapp","host":"product","path":"/123","params":[{"key":"ref","value":"email"}]}'

Response

{
  "ok": true,
  "data": {
    "result": "myapp://product/123?ref=email"
  }
}

POST/v1/generators/emoji-search1 credit / call

Emoji / symbol search

Search the curated emoji and symbol catalog by name or keyword.

Parameter	Type	Required	Description
query	string	Yes	Search term, e.g. "heart" or "smile".
limit	number	No	Maximum matches to return (1-100). Default: 20.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/emoji-search \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"query":"heart"}'

Response

{
  "ok": true,
  "data": {
    "matches": [
      {
        "char": "❤️",
        "name": "Red Heart",
        "group": "Symbols"
      }
    ]
  }
}

POST/v1/generate/cuid1 credit / call

CUID generator

Generate one or more collision-resistant CUID-style identifiers using secure randomness.

Parameter	Type	Required	Description
count	number	No	Number of identifiers from 1 to 100. Default: 1.

Request

curl -X POST https://toolsonduty.com/api/v1/generate/cuid \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"count":2}'

Response

{
  "ok": true,
  "data": {
    "values": [
      "cm...",
      "cm..."
    ]
  }
}

POST/v1/generate/user-agent1 credit / call

User-Agent generator

Generate a plausible browser User-Agent for a selected operating system and version.

Parameter	Type	Required	Description
browser	string	No	chrome \| firefox \| safari \| edge. Default: chrome.
os	string	No	windows \| macos \| linux \| android \| ios. Default: windows.
version	string	No	Browser version with 1 to 4 numeric segments. Default: 125.

Request

curl -X POST https://toolsonduty.com/api/v1/generate/user-agent \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"browser":"chrome","os":"windows","version":"125"}'

Response

{
  "ok": true,
  "data": {
    "result": "Mozilla/5.0 ..."
  }
}

POST/v1/generate/test-imei1 credit / call

Test IMEI generator

Generate synthetic checksum-valid IMEI-format values for software testing only.

Parameter	Type	Required	Description
tac	string	No	Eight-digit test TAC. Default: 35693803.
count	number	No	Number of values from 1 to 100. Default: 1.

Request

curl -X POST https://toolsonduty.com/api/v1/generate/test-imei \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"tac":"35693803","count":2}'

Response

{
  "ok": true,
  "data": {
    "values": [
      "35693803...",
      "35693803..."
    ]
  }
}