Assets

Get paginated list of image assets

Retrieve a paginated list of user-uploaded image assets.

GET
/assets
AuthorizationBearer <token>

Token-based authentication using access tokens.

In: header

Query Parameters

page?Page

Page number.

Default1
per_page?Per Page

Items per page.

Default20
Range1 <= value <= 100
order?Order

Sort order.

Default"desc"
Value in"asc" | "desc"
created_by?Created By

Filter by uploader username (case-insensitive partial match).

Defaultnull
created_after?Created After

Filter assets created after this timestamp (ISO 8601 format).

Defaultnull
created_before?Created Before

Filter assets created before this timestamp (ISO 8601 format).

Defaultnull
sort_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.

Defaultnull

Response 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"
      ],
      "thumbnail_big": null,
      "thumbnail_small": null
    }
  ]
}
Empty
Empty