> ## 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 Avatar

Upload a new avatar via multipart form upload.

## Behavior

* Accepts `.png`, `.jpg`, `.webp`, `.gif` up to **30 MB**.
* Image is square-cropped to the shorter side using a centered crop.
* Stored under `avatars/{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/avatar" \
  -H "relay-key: YOUR_RELAY_KEY" \
  -F "file=@avatar.png"
```

## Responses

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