avatars

Update avatar data

Updates the avatar data for a given avatar for the authenticated user.

patch/me/avatars/{imageHash}

Request

Base URL: https://api.gravatar.com/v3
URL: https://api.gravatar.com/v3/me/avatars/{imageHash}
Auth: OAuth 2 (implicit, authorization URL https://public-api.wordpress.com/oauth2/authorize)

Path parameters

imageHashstring required

The hash of the avatar to update.

Request body

rating'G' | 'PG' | 'R' | 'X'

Rating associated with the image.

alt_textstring

Alternative text description of the image.

Example request

{
  "alt_text": "Gravatar's avatar image. Gravatar is a service for providing globally unique avatars."
}

Response

Avatar updated successfully

image_idstring required

Unique identifier for the image.

image_urlstring uri required

Image URL

rating'G' | 'PG' | 'R' | 'X' required

Rating associated with the image.

alt_textstring required

Alternative text description of the image.

selectedboolean

Whether the image is currently selected as the provided selected email's avatar.

updated_datestring date-time required

Date and time when the image was last updated.

Example response

{
  "image_id": "38be15a98a2bbc40df69172a2a8349",
  "image_url": "https://gravatar.com/userimage/252014526/d38bele5a98a2bbc40df69172a2a8348.jpeg",
  "alt_text": "Gravatar's avatar image. Gravatar is a service for providing globally unique avatars.",
  "selected": true,
  "updated_date": "2021-10-01T12:00:00Z"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.