Profile

Upload Avatar / Banner

Upload a new avatar or banner for the logged-in account. Provide the image via URL, base64, or a server-local path (PNG/JPEG, auto-detected). Provide exactly one of image_url, image_base64, or image_path. Session cookies are optional when a Reddit session is connected through POST /api/reddit/session: a call that sends none acts as the stored session, and cookies you do send always win. Cost: $0.012 per call.

post/api/reddit/profile/avatar

Request

  • Base URL: https://api.redditapis.com
  • URL: https://api.redditapis.com/api/reddit/profile/avatar
  • Auth: HTTP bearer

Request body

image_urlstring

Publicly-fetchable image URL — the server downloads it

image_base64string

Base64-encoded image (with or without data:image/...;base64, prefix)

image_pathstring

Server-local path (rarely useful)

kindstring

avatar (default) or banner

mimetypestring

Hint (PNG / JPG) — auto-detected from bytes if omitted

filenamestring

Filename to record (default avatar.png)

reddit_sessionstring

Account session cookie (from /api/reddit/login)

csrf_tokenstring

Reddit CSRF token cookie

loidstring

Account loid cookie (from /api/reddit/login)

max_attemptsinteger

Retry budget (default 3)

Response

Successful response.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.