📄 Pagination & Sorting
All list endpoints (e.g., /listProjects
, /project/{projectId}/tasks
) support pagination and sorting to efficiently handle large datasets.
Query Parameters
Parameter
Type
Default
Description
page
integer
1
Page number to retrieve (1-indexed)
limit
integer
10
Number of items per page (max: 100)
sort
string
-createdAt
Field to sort by. Prefix with -
for descending order
Sorting Examples
# Get newest projects first (default)
GET /listProjects?sort=-createdAt
# Get oldest projects first
GET /listProjects?sort=createdAt
# Sort alphabetically by name
GET /listProjects?sort=name
# Sort by name descending (Z to A)
GET /listProjects?sort=-name
Pagination Examples
# Get first page with 10 items
GET /listProjects?page=1&limit=10
# Get second page with 50 items
GET /listProjects?page=2&limit=50
# Get all projects (up to 100 per page)
GET /listProjects?limit=100