summaryrefslogtreecommitdiff
path: root/doc/api/avatar.md
blob: aa6f7c185aee2731e4441d0bfa1cc683735e4e54 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
# Avatar API

> [Introduced][ce-19121] in GitLab 11.0

## Get a single avatar URL

Get a single avatar URL for a given email address. If user with matching public
email address is not found, results from external avatar services are returned.
This endpoint can be accessed without authentication. In case public visibility
is restricted, response will be `403 Forbidden` when unauthenticated.

```
GET /avatar?email=admin@example.com
```

| 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 |

```bash
curl https://gitlab.example.com/api/v4/avatar?email=admin@example.com
```

Example response:

```json
{
  "avatar_url": "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80\u0026d=identicon"
}
```

[ce-19121]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/19121