Skip to content

Image Upload

Uploads an image for profile, cover, or plugin-asset style use cases.

Method and path

  • Method: POST
  • Path: /me/uploads/images
  • Auth: required
  • Content-Type: multipart/form-data

Form fields

  • category: category key matching ^[a-z0-9][a-z0-9_-]{0,31}$
  • file: image file payload

Constraints

  • Max size: 4MB
  • Allowed MIME:
  • image/jpeg
  • image/png
  • image/webp
  • image/gif
  • image/bmp
  • image/svg+xml

Response

  • 200 OK: upload metadata

Key fields:

  • id
  • category
  • provider
  • objectKey
  • url
  • size
  • mimeType
  • createdAt