Upload your profile picture

PUT

/v1/me/avatar

curl --request PUT \
  --url https://api.gampeon.com/v1/me/avatar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: image/png' \
  --data binary

• Production

PNG, JPEG or WebP up to 2 MB, no animation. The server removes all metadata (EXIF including GPS position, XMP, IPTC, comments, embedded thumbnails) and gives the file a new random name. Replacing an image deletes the old one. At least 128×128 pixels, roughly square (crop before uploading).

Not available with access tokens.

Rate limit: 30 uploads per hour per account.

Authorizations

• session

Request Body^required

The image

string format: binary

string format: binary

string format: binary

Responses

201

Stored and set as the current image

Media typeapplication/json

object

url

required

Image path relative to the API (/v1/media/…)

string

width

required

integer

height

required

integer

Example ^generated

{
  "url": "example",
  "width": 1,
  "height": 1
}

400

Error codes: invalid_image, upload_incomplete

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

401

Error codes: unauthorized

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

403

Error codes: token_not_allowed

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

411

Error codes: length_required

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

413

Error codes: file_too_large

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

415

Error codes: unsupported_media_type, invalid_image, animated_image

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

422

Error codes: image_too_small, invalid_aspect_ratio

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

429

Limit: 30 uploads per hour per account. Error codes: rate_limited

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

503

Error codes: storage_disabled

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}