Poster

Upload event poster images to AWS S3. Returns a public URL for the uploaded image.

Upload event poster image

post

https://events.decentraland.org/apihttps://events.decentraland.zone/apihttp://localhost:4000/api

/poster

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

Body

multipart/form-data

posterstring · binaryRequired

Image file (JPEG, PNG, GIF, or WebP, max 500KB)

Responses

200

Image uploaded successfully

application/json

okbooleanOptionalExample: true

400

Bad request - invalid parameters or body

application/json

401

Unauthorized - authentication required

application/json

413

Payload too large (file size exceeds 500KB)

application/json

500

Internal server error

application/json

503

Service unavailable (AWS S3 issue)

application/json

post/poster

HTTPcURLJavaScriptPython

POST /api/poster HTTP/1.1
Host: events.decentraland.org
Content-Type: multipart/form-data
Accept: */*
Content-Length: 19

{
  "poster": "binary"
}

{
  "ok": true,
  "data": {
    "filename": "poster/abc123def456.jpg",
    "url": "https://events-cdn.decentraland.org/poster/abc123def456.jpg",
    "size": 245760,
    "type": "image/jpeg"
  }
}

Upload vertical event poster image

post

https://events.decentraland.org/apihttps://events.decentraland.zone/apihttp://localhost:4000/api

/poster-vertical

Uploads a vertical event poster image to AWS S3 and returns the public URL. This endpoint is specifically for portrait-oriented images.

Format: PNG, JPG or WebP only (no GIF) Recommended size: 716 x 1814 pixels Max weight: 500 KB

Body

multipart/form-data

posterstring · binaryRequired

Vertical image file (PNG, JPG or WebP only, max 500KB, recommended 716x1814 pixels)

Responses

200

Vertical image uploaded successfully

application/json

okbooleanOptionalExample: true

400

Bad request (invalid file type - only PNG, JPG and WebP allowed)

application/json

401

Unauthorized - authentication required

application/json

413

Payload too large (file size exceeds 500KB)

application/json

500

Internal server error

application/json

503

Service unavailable (AWS S3 issue)

application/json

post/poster-vertical

HTTPcURLJavaScriptPython

POST /api/poster-vertical HTTP/1.1
Host: events.decentraland.org
Content-Type: multipart/form-data
Accept: */*
Content-Length: 19

{
  "poster": "binary"
}

{
  "ok": true,
  "data": {
    "filename": "poster/abc123def456.jpg",
    "url": "https://events-cdn.decentraland.org/poster/abc123def456.jpg",
    "size": 245760,
    "type": "image/jpeg"
  }
}