---
title: "Upload event poster image"
method: POST
path: "/poster"
tags: ["Poster"]
---

# Upload event poster image

`POST /poster`

Uploads an event poster image to AWS S3 and returns the public URL.
Maximum file size: 500KB. Supported formats: JPEG, PNG, GIF, WebP.

## Response `200`

Image uploaded successfully

- object
  - `ok` boolean
  - `data` object — Uploaded poster image information
    - `filename` string, required — File path in S3 bucket
    - `url` string, uri, required — Public URL to access the image
    - `size` integer, required — File size in bytes
    - `type` 'image/jpeg' | 'image/png' | 'image/gif' | 'image/webp', required — MIME type

## Other responses

- `400` — Bad request - invalid parameters or body
- `401` — Unauthorized - authentication required
- `413` — Payload too large (file size exceeds 500KB)
- `500` — Internal server error
- `503` — Service unavailable (AWS S3 issue)

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)