Generation History

History endpoints let you list, inspect, annotate, and delete generation records.

Endpoints

Method	Endpoint	Purpose
GET	/user/generation-history	List generation records
GET	/user/generation-history/:id	Read one generation record
PATCH	/user/generation-history/feedback/:id	Attach or update feedback
DELETE	/user/generation-history/:id	Delete a record

All endpoints require:

Authorization: Bearer <api_key>

Listing Records

GET /user/generation-history?page=1&limit=10&generation_type=<uuid>&status=pending&status=complete

{
  "page": 1,
  "count": 1,
  "total_count": 12,
  "pages": 12,
  "items": [
    {
      "id": "5f8d0d55b54764421b7156c5",
      "generation_type": "fashion_swap",
      "status": "complete",
      "created_at": "2026-03-24T10:15:00Z",
      "preview_url": "/image/generation_result/preview.webp",
      "stock_url": "/image/generation_result/stock.png",
      "like": true
    }
  ]
}

Example:

• GET /user/generation-history examples

Filters and Pagination

Parameter	Type	Description
page	integer	Page number (1-based)
limit	integer	Records per page (1..100)
generation_type	uuid	Filter by generation type id
status	array	Repeated query param with values pending, complete, error

Updating Feedback

PATCH /user/generation-history/feedback/3fbc2c6e-45a1-47f9-bc22-cc3b93e5b243
Content-Type: application/json
Authorization: Bearer <api_key>

{
  "like": true
}

Example:

• PATCH /user/generation-history/feedback/:id examples

Deleting a Record

DELETE /user/generation-history/3fbc2c6e-45a1-47f9-bc22-cc3b93e5b243
Authorization: Bearer <api_key>

Example:

• DELETE /user/generation-history/:id examples

Example Links

• List history: GET /user/generation-history examples
• Check one record: GET /user/generation-history/:id examples
• Send feedback: PATCH /user/generation-history/feedback/:id examples
• Delete record: DELETE /user/generation-history/:id examples