Upload Avatar

POST /actions/FileUploader

Uploads a new profile avatar.

Rate limits

No known rate limit

Request

Authenticated: Yes

Method: POST

Host: steamcommunity.com

Path: /actions/FileUploader

Form Data:

Name	Type	Required	Description
sessionid	string	Yes	The value of the sessionid cookie
sId	string	Yes	The 64-bit SteamID of the profile
type	string	Yes	The upload type, player_avatar_image for a profile avatar
doSub	number	Yes	Always 1
json	number	Yes	1 to receive a JSON response instead of the avatar editor page
avatar	file	Yes	The image file (jpg, png or gif)
MAX_FILE_SIZE	number	No	The size of avatar in bytes; the profile settings form sends 1048576

Response

200 OK

Name	Type	Description
success	boolean	Whether the request was successful
images	object	URLs of the stored avatar images
images.0	string	URL of the small avatar
images.full	string	URL of the full-size avatar
images.medium	string	URL of the medium avatar
hash	string	The hash of the uploaded avatar
message	string	The error message; empty when the request was successful

Without sessionid or sId the response body is the plain-text #Error_BadOrMissingSteamID.

400 Bad Request

Name	Type	Description
success	boolean	Whether the request was successful
images	array	Empty when the upload was rejected
hash	string	null when the upload was rejected
message	string	The error message, e.g. No file received.

Example

POST https://steamcommunity.com/actions/FileUploader

{
    "success": true,
    "images": {
        "0": "https://avatars.fastly.steamstatic.com/91d0c8997dd7ff9005f6532490d47a7bf20e0167.jpg",
        "full": "https://avatars.fastly.steamstatic.com/91d0c8997dd7ff9005f6532490d47a7bf20e0167_full.jpg",
        "medium": "https://avatars.fastly.steamstatic.com/91d0c8997dd7ff9005f6532490d47a7bf20e0167_medium.jpg"
    },
    "hash": "91d0c8997dd7ff9005f6532490d47a7bf20e0167",
    "message": ""
}