Skip to main content
POST
/
api
/
v1
/
files.json
Upload File
curl --request POST \
  --url https://api.launchmystore.io/api/v1/files.json \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "alt": "<string>",
  "folder": "<string>"
}
'
{
  "success": true,
  "data": {
    "id": "file_new789",
    "filename": "banner-summer-sale.png",
    "url": "https://cdn.launchmystore.io/files/banner-summer-sale.png",
    "alt": "Summer sale banner",
    "content_type": "image/png",
    "size": 156234,
    "width": 1200,
    "height": 400,
    "created_at": "2024-01-20T14:30:00Z"
  }
}
Not available yet. The app-scoped Files API (/api/v1/files*) is not implemented — calls will 404. read_files / write_files are reserved scopes (requestable for forward-compat) with no endpoints bound yet. The shape below is the planned contract and may change.

​
Body Parameters

​
file
file
required
The file to upload (multipart/form-data)
​
alt
string
Alt text for the image (for accessibility)
​
folder
string
Optional folder path for organization

​
Supported File Types

TypeExtensionsMax Size
Imagesjpg, jpeg, png, gif, webp, svg20MB
Videosmp4, webm, mov100MB
Documentspdf, doc, docx10MB

​
Response

{
  "success": true,
  "data": {
    "id": "file_new789",
    "filename": "banner-summer-sale.png",
    "url": "https://cdn.launchmystore.io/files/banner-summer-sale.png",
    "alt": "Summer sale banner",
    "content_type": "image/png",
    "size": 156234,
    "width": 1200,
    "height": 400,
    "created_at": "2024-01-20T14:30:00Z"
  }
}

​
Example Request

curl -X POST "https://api.launchmystore.io/api/v1/files.json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@/path/to/image.jpg" \
  -F "alt=Product image"