Assets
Get paginated list of image assets
Retrieve a paginated list of user-uploaded image assets.
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"created_by?Created By
Filter by uploader username (case-insensitive partial match).
Default
nullcreated_after?Created After
Filter assets created after this timestamp (ISO 8601 format).
Default
nullcreated_before?Created Before
Filter assets created before this timestamp (ISO 8601 format).
Default
nullsort_by?Sort By
Sort by field.
Default
"created_at"Value in
"filename" | "created_at"search?Search
General search term to match against tags, filename or project name.
Default
nullownership?Ownership
Filter by ownership: 'mine' for own assets, 'shared' for group members' assets, 'default' for platform assets.
Default
nullinclude_tags?Include Tags
Comma-separated tags the asset must have (AND logic). Allowed: model, product, background, other.
Default
nullexclude_tags?Exclude Tags
Comma-separated tags the asset must NOT have (AND-NOT logic). Allowed: model, product, background, other.
Default
nullResponse Body
Examples
curl -X GET "https://v2.api.piktid.com/assets?page=1&per_page=20&order=asc&sort_by=filename"{
"pagination": {
"page": 0,
"per_page": 0,
"total": 0,
"pages": 0,
"has_next": true,
"has_prev": true
},
"assets": [
{
"id": "string",
"filename": "string",
"url": "string",
"created_at": "string",
"created_by": "string",
"tags": [
"string"
],
"visibility": "private",
"thumbnail_big": null,
"thumbnail_small": null
}
]
}{
"error": "Invalid request",
"detail": [
{
"field": null,
"message": "string",
"position": "query"
}
]
}Empty