Albums

LIVE

Photo albums owned by users. Photos use albumId to group into these albums.

Endpoints

GETPOSTList or create
/api/albums
GETPATCHDELETERead, update, or delete one
/api/albums/:id
GETFilter by owner
/api/albums?userId=
GETSearch title
/api/albums?search=city

Query params

Param	Description	Example
search	Search album title	search=city
userId	Filter by owner UUID	userId=…
sort	createdAt · title · id · default id	sort=title
page	Page number · default 1	page=2
limit	Page size · default 12 · max 50	limit=12
order	asc · desc	order=asc
lang	Pass fa for Persian text · omit for English (default)	lang=fa
delay	Artificial wait in ms · max 5000	delay=800
status	Force error HTTP status · 400–599	status=500

Persian text: add lang=fa. See Docs · Language.

Try:/api/albums?limit=8

Request

1const { data } = await axios.get('/api/albums');

Response

1{2  "data": [3    {4      "id": 1,5      "userId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",6      "title": "City walks",7      "createdAt": "2026-09-14T10:00:00.000Z",8      "updatedAt": "2026-09-14T10:00:00.000Z"9    }10  ],11  "pagination": {12    "page": 1,13    "limit": 12,14    "total": 8,15    "totalPages": 116  }17}