List generations

Read saved generations newest first.

{
    "title": "List generations",
    "description": "",
    "method": "GET",
    "baseUrl": "https://app.docuwriter.ai",
    "endpoint": "/api/generations",
    "headers": [
        {
            "key": "Authorization",
            "value": "Bearer YOUR_API_TOKEN",
            "type": "string",
            "required": true
        },
        {
            "key": "Accept",
            "value": "application/json",
            "type": "string",
            "required": true
        }
    ],
    "queryParams": [
        {
            "key": "per_page",
            "value": "1\u2013100; default 20.",
            "type": "integer",
            "required": false
        },
        {
            "key": "page",
            "value": "Paginator page.",
            "type": "integer",
            "required": false
        },
        {
            "key": "archived",
            "value": "Optional; omitted returns non-archived only.",
            "type": "boolean",
            "required": false
        },
        {
            "key": "type",
            "value": "Stored generation type; see documented values above.",
            "type": "string",
            "required": false
        }
    ],
    "pathParams": [],
    "bodyType": "none",
    "requestBody": "",
    "formData": [],
    "rawBody": "",
    "responses": {
        "200": {
            "description": "HTTP 200: success: true, data array, meta.current_page, last_page, per_page, total. Items contain uuid, generated_by_user_email, filename, generated, created_at, updated_at, generation_type, tag. Illustrative JSON example; sample values are fictional. Some optional or additional resource fields may be omitted.",
            "body": "{\n  \"success\": true,\n  \"data\": [\n    {\n      \"uuid\": \"00000000-0000-4000-8000-000000000456\",\n      \"generated_by_user_email\": \"[email protected]\",\n      \"filename\": \"add.js\",\n      \"generated\": \"# add\\n\\nReturns the sum of two numbers.\",\n      \"created_at\": \"2026-09-28T10:00:00.000000Z\",\n      \"updated_at\": \"2026-09-28T10:00:00.000000Z\",\n      \"generation_type\": 0,\n      \"tag\": null\n    }\n  ],\n  \"meta\": {\n    \"current_page\": 1,\n    \"last_page\": 1,\n    \"per_page\": 20,\n    \"total\": 1\n  }\n}"
        },
        "401": {
            "description": "Missing or invalid account API token.Missing or invalid account API token. Example JSON response.",
            "body": "{\n  \"message\": \"Unauthenticated.\"\n}"
        }
    }
}

Request notes

• Optional per_page: integer 1–100, default 20. page selects a paginator page.
• Optional archived: boolean; omitted defaults to non-archived only.
• Optional type filters the stored numeric generation type, supplied as a query string.
• Common values: documentation 0, tests 1, optimization 2, conversion 3, Swagger 5, comments 6, diagrams 7.

Usage notes

• Results belong to the authenticated account relationship.
• This list returns UUIDs but the detail endpoint expects a numeric ID.
• Save generation_id from a generation response, or use My generations to retrieve numeric IDs.
• 422 for invalid filters.

API authentication.