Endpoint
POST https://requiems.xyz/v1/entertainment/sudoku/batch
Batch Generate Sudoku Puzzles
Generate up to 20 Sudoku puzzles in a single request. Results are returned in the same order as the input array. Each puzzle in the batch counts as one unit of API usage.
Parameters
| Name |
Type |
Required |
Location |
Description |
puzzles |
array |
yes |
body |
Array of difficulty levels to generate (min: 1, max: 20). Each must be one of: easy, medium, hard. |
Request Example
{
"puzzles": ["easy", "hard"]
}
Response Example
{
"data": {
"results": [
{
"difficulty": "easy",
"puzzle": [
[5, 3, 0, 0, 7, 0, 0, 0, 0],
[6, 0, 0, 1, 9, 5, 0, 0, 0],
[0, 9, 8, 0, 0, 0, 0, 6, 0],
[8, 0, 0, 0, 6, 0, 0, 0, 3],
[4, 0, 0, 8, 0, 3, 0, 0, 1],
[7, 0, 0, 0, 2, 0, 0, 0, 6],
[0, 6, 0, 0, 0, 0, 2, 8, 0],
[0, 0, 0, 4, 1, 9, 0, 0, 5],
[0, 0, 0, 0, 8, 0, 0, 7, 9]
],
"solution": [
[5, 3, 4, 6, 7, 8, 9, 1, 2],
[6, 7, 2, 1, 9, 5, 3, 4, 8],
[1, 9, 8, 3, 4, 2, 5, 6, 7],
[8, 5, 9, 7, 6, 1, 4, 2, 3],
[4, 2, 6, 8, 5, 3, 7, 9, 1],
[7, 1, 3, 9, 2, 4, 8, 5, 6],
[9, 6, 1, 5, 3, 7, 2, 8, 4],
[2, 8, 7, 4, 1, 9, 6, 3, 5],
[3, 4, 5, 2, 8, 6, 1, 7, 9]
]
}
],
"total": 1
},
"metadata": {
"timestamp": "2026-01-01T00:00:00Z"
}
}
Response Fields
| Field |
Type |
Description |
results |
array |
Generated puzzles in the same order as the input array. Each item has the same fields as the single-puzzle endpoint. |
results[].difficulty |
string |
The difficulty level of the puzzle (easy, medium, or hard) |
results[].puzzle |
array |
9×9 grid as an array of 9 rows, each row an array of 9 integers — 0 means an empty cell to be filled in |
results[].solution |
array |
9×9 grid as an array of 9 rows, each row an array of 9 integers — complete, valid solution |
total |
integer |
Number of puzzles returned. Matches the length of the input array. |
Errors
400 bad_request — The request body is missing or contains malformed JSON.422 validation_failed — The puzzles array is missing, empty, exceeds 20 items, or contains a value other than easy, medium, or hard.401 unauthorized — Missing API key403 forbidden — Invalid or revoked API key
1---2name: sudoku-post-batch3description: Generate up to 20 Sudoku puzzles in a single request. Results are returned in the same order as the input array. Each puzzle in the batch counts as one unit of API usage.4---5
6## Endpoint
7
8**POST https://requiems.xyz/v1/entertainment/sudoku/batch**
9
10## Batch Generate Sudoku Puzzles
11
12Generate up to 20 Sudoku puzzles in a single request. Results are returned in the same order as the input array. Each puzzle in the batch counts as one unit of API usage.
13
14## Parameters
15
16| Name | Type | Required | Location | Description |
17| ---- | ---- | -------- | -------- | ----------- |
18| `puzzles` | array<string> | yes | body | Array of difficulty levels to generate (min: 1, max: 20). Each must be one of: easy, medium, hard. |
19
20## Request Example
21
22```json
23{
24 "puzzles": ["easy", "hard"]
25}
26```
27
28## Response Example
29
30```json
31{
32 "data": {
33 "results": [
34 {
35 "difficulty": "easy",
36 "puzzle": [
37 [5, 3, 0, 0, 7, 0, 0, 0, 0],
38 [6, 0, 0, 1, 9, 5, 0, 0, 0],
39 [0, 9, 8, 0, 0, 0, 0, 6, 0],
40 [8, 0, 0, 0, 6, 0, 0, 0, 3],
41 [4, 0, 0, 8, 0, 3, 0, 0, 1],
42 [7, 0, 0, 0, 2, 0, 0, 0, 6],
43 [0, 6, 0, 0, 0, 0, 2, 8, 0],
44 [0, 0, 0, 4, 1, 9, 0, 0, 5],
45 [0, 0, 0, 0, 8, 0, 0, 7, 9]
46 ],
47 "solution": [
48 [5, 3, 4, 6, 7, 8, 9, 1, 2],
49 [6, 7, 2, 1, 9, 5, 3, 4, 8],
50 [1, 9, 8, 3, 4, 2, 5, 6, 7],
51 [8, 5, 9, 7, 6, 1, 4, 2, 3],
52 [4, 2, 6, 8, 5, 3, 7, 9, 1],
53 [7, 1, 3, 9, 2, 4, 8, 5, 6],
54 [9, 6, 1, 5, 3, 7, 2, 8, 4],
55 [2, 8, 7, 4, 1, 9, 6, 3, 5],
56 [3, 4, 5, 2, 8, 6, 1, 7, 9]
57 ]
58 }
59 ],
60 "total": 1
61 },
62 "metadata": {
63 "timestamp": "2026-01-01T00:00:00Z"
64 }
65}
66```
67
68## Response Fields
69
70| Field | Type | Description |
71| ----- | ---- | ----------- |
72| `results` | array<object> | Generated puzzles in the same order as the input array. Each item has the same fields as the single-puzzle endpoint. |
73| `results[].difficulty` | string | The difficulty level of the puzzle (easy, medium, or hard) |
74| `results[].puzzle` | array<object> | 9×9 grid as an array of 9 rows, each row an array of 9 integers — 0 means an empty cell to be filled in |
75| `results[].solution` | array<object> | 9×9 grid as an array of 9 rows, each row an array of 9 integers — complete, valid solution |
76| `total` | integer | Number of puzzles returned. Matches the length of the input array. |
77
78## Errors
79
80- `400` **bad_request** — The request body is missing or contains malformed JSON.
81- `422` **validation_failed** — The puzzles array is missing, empty, exceeds 20 items, or contains a value other than easy, medium, or hard.
82- `401` **unauthorized** — Missing API key
83- `403` **forbidden** — Invalid or revoked API key
gabrielmoreira