Skip to main content
GET
/
assets
List Assets
curl --request GET \
  --url https://api.supapost.so/assets
{
  "object": "list",
  "data": [
    {
      "id": "asset-uuid",
      "name": "photo.jpg",
      "url": "https://cdn.supapost.so/assets/team/photo.jpg",
      "content_type": "image/jpeg",
      "size_bytes": 245000,
      "width": 1080,
      "height": 1920,
      "source": "upload",
      "metadata": null,
      "created_at": "2026-04-07T12:00:00Z"
    }
  ],
  "has_more": true,
  "url": "/assets"
}
Returns assets for the current team, sorted by most recently created. Supports Stripe-style pagination and optional source filtering.

​
Authentication

​
Authorization
string
Bearer token. Bearer <supabase-jwt>.

​
Query Parameters

​
source
string
Filter by asset source. One of "upload", "ai_generated", or "export".
​
limit
integer
default:"15"
Number of records to return. Maximum 100.
​
starting_after
string
Return items after this asset ID.
​
ending_before
string
Return items before this asset ID.
{
  "object": "list",
  "data": [
    {
      "id": "asset-uuid",
      "name": "photo.jpg",
      "url": "https://cdn.supapost.so/assets/team/photo.jpg",
      "content_type": "image/jpeg",
      "size_bytes": 245000,
      "width": 1080,
      "height": 1920,
      "source": "upload",
      "metadata": null,
      "created_at": "2026-04-07T12:00:00Z"
    }
  ],
  "has_more": true,
  "url": "/assets"
}