> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snipp.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload Banner

Upload a new banner via multipart form upload.

## Behavior

* Accepts `.png`, `.jpg`, `.webp`, `.gif` up to **30 MB**.
* Banner keeps its original aspect ratio (no crop).
* Stored under `banners/{userId}/` on the Snipp CDN.
* Sets the field on your profile automatically. No follow-up [`/profile`](/relay-reference/endpoint/profile) call required.

## Examples

```bash theme={null}
curl -X POST "https://relay.snipp.gg/profile/banner" \
  -H "relay-key: YOUR_RELAY_KEY" \
  -F "file=@banner.png"
```

## Responses

```json theme={null}
{
  "url": "https://i.snipp.gg/banners/123456789012345678/banner.png",
  "type": "banner"
}
```