Skip to content

Latest commit

 

History

History
47 lines (33 loc) · 1.71 KB

avatar.md

File metadata and controls

47 lines (33 loc) · 1.71 KB
stage group info
none
unassigned
To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments

Avatar API

Introduced in GitLab 11.0.

Get a single avatar URL

Get a single avatar URL for a user with the given email address.

If:

  • No user with the given public email address is found, results from external avatar services are returned.
  • Public visibility is restricted, response is 403 Forbidden when unauthenticated.

NOTE: Note: This endpoint can be accessed without authentication.

Parameters:

Attribute Type Required Description
email string yes Public email address of the user.
size integer no Single pixel dimension (since images are squares). Only used for avatar lookups at Gravatar or at the configured Libravatar server.

Example request:

curl "https://gitlab.example.com/api/v4/[email protected]&size=32"

Example response:

{
  "avatar_url": "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=64&d=identicon"
}