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