Skip to main content
GET
/
api
/
v1
/
files.json
List Files
curl --request GET \
  --url https://api.launchmystore.io/api/v1/files.json \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "files": [
      {
        "id": "file_abc123",
        "filename": "product-hero.jpg",
        "url": "https://cdn.launchmystore.io/files/product-hero.jpg",
        "alt": "Product hero image",
        "content_type": "image/jpeg",
        "size": 245678,
        "width": 1920,
        "height": 1080,
        "created_at": "2024-01-15T10:30:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "total": 156,
      "hasMore": true
    }
  }
}
Not available yet. The app-scoped Files API (/api/v1/files*) is not implemented — calls will 404. The read_files / write_files scopes are reserved in the OAuth catalog (requestable for forward-compat) but no file endpoints are bound. The shapes below are the planned contract and may change. To read/write theme assets today use the Themes assets endpoints (read_themes / write_themes); to pick existing media in an embedded UI use the App Bridge file resource picker (no app scope required).

​
Query Parameters

​
page
number
default:"1"
Page number
​
limit
number
default:"50"
Items per page (max 250)
​
type
string
Filter by file type: image, video, document

​
Response

​
success
boolean
Request success status
​
data
object
{
  "success": true,
  "data": {
    "files": [
      {
        "id": "file_abc123",
        "filename": "product-hero.jpg",
        "url": "https://cdn.launchmystore.io/files/product-hero.jpg",
        "alt": "Product hero image",
        "content_type": "image/jpeg",
        "size": 245678,
        "width": 1920,
        "height": 1080,
        "created_at": "2024-01-15T10:30:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "total": 156,
      "hasMore": true
    }
  }
}