Generate

Generate random strings

POST/v1/generate/string/{charset}

View as Markdown

Generates between 1 and 100 random strings made of letters and digits, hexadecimal characters or digits only. The body is optional and sets the count and the length.

Parameters

Name Type Required Description
charset one of: alphanumeric, hex, digits yes

Request body

Name Type Required Description
count integer no Number of IDs to generate (1-100) (default 1)
length integer no Length of the random string (3-32 characters) (default 16)

Example request

A request body that works, as JSON.

{
  "length": 16
}

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": [
      "E1fhkCtirys4fzl3"
    ],
    "type": "random_alphanumeric",
    "count": 1
  },
  "errors": null,
  "meta": {
    "request_id": "bb88085c-d067-4303-8520-e9cbae0b3694",
    "timestamp": "2026-10-27T07:19:42.077743Z",
    "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