API Docs

Upload

POST /api/uploadas multipart form data. Fieldfileis required.expiryis optional:1h,1d,7d,30d, ornever. Defaults to one day.

curl -F file=@pudding.jpg -F expiry=1d https://pom.st/api/upload

{
  "id": "ab23defg",
  "name": "pudding.jpg",
  "size": 14200,
  "content_type": "image/jpeg",
  "expiry": "1d",
  "expires_at": "2026-09-12T05:00:00Z",
  "url": "/ab23defg"
}

Share & download

Preview lives athttps://pom.st/{id}. The raw file is/{id}/download. Add?inline=1to display it in a browser.

curl -O -J https://pom.st/ab23defg/download

File info

GET /api/v1/files/{id}returns the same JSON as upload, without the bytes.