Gallery
Gallery of images grouped by project
Returns image results organized by project with pagination support. Includes project statistics and filtered/sorted image results.
AuthorizationBearer <token>
Token-based authentication using access tokens.
In: header
Query Parameters
page?Page
Page number.
Default
1per_page?Per Page
Items per page.
Default
20Range
1 <= value <= 100order?Order
Sort order.
Default
"desc"Value in
"asc" | "desc"project_id?Project Id
Filter by specific project ID (optional).
Default
nullstatus?Status
Filter by image status (optional).
Default
nullfeedback?Feedback
Filter by feedback status (optional). Can include multiple values.
Default
nullsort_by?Sort By
Sort by field (default: original_filename).
Default
"original_filename"Value in
"original_filename" | "quality_score"ownership?Ownership
Filter by ownership: 'mine' for own items, 'shared' for group members' items.
Default
nullmax_images_per_project?Max Images Per Project
Limit images per project (default: 50, max: 200).
Default
50Range
1 <= value <= 200search?Search
Search by project name, key, or ID (optional).
Default
nullResponse Body
Examples
curl -X GET "https://v2.api.piktid.com/gallery/by-project?page=1&per_page=20&order=asc&sort_by=original_filename&max_images_per_project=50"{
"pagination": {
"page": 0,
"per_page": 0,
"total": 0,
"pages": 0,
"has_next": true,
"has_prev": true
},
"projects": [
{
"project_id": 0,
"project_name": "string",
"project_key": "string",
"created_at": "string",
"created_by": "string",
"total_images": 0,
"completed_images": 0,
"failed_images": 0,
"images": [
{
"job_id": "string",
"image_index": 0,
"group_index": 0,
"version": 0,
"original_filename": "string",
"download_filename": null,
"inputs": [
{
"full_size": null,
"thumbnail": null
}
],
"output": {
"full_size": null,
"thumbnail": null
},
"input_description": {},
"status": "string",
"quality_score": 0,
"processing_time": 0,
"error_message": "string",
"feedback": "like",
"feedback_comment": "string",
"created_at": "string",
"review_status": null,
"review_annotations": null,
"retouch_claim": null
}
]
}
]
}{
"error": "Invalid request",
"detail": [
{
"field": null,
"message": "string",
"position": "query"
}
]
}Empty