---
title: "Get all project avatars"
method: GET
path: "/rest/api/3/project/{projectIdOrKey}/avatars"
tags: ["Project avatars"]
---

# Get all project avatars

`GET /rest/api/3/project/{projectIdOrKey}/avatars`

Returns all project avatars, grouped by system and custom avatars.

This operation can be accessed anonymously.

**[Permissions](#permissions) required:** *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project.

## Path parameters

- `projectIdOrKey` string, required

## Response `200`

Returned if request is successful.

- ProjectAvatars — List of project avatars.
  - `custom` Avatar[] — List of avatars added to Jira. These avatars may be deleted.
    - `fileName` string — The file name of the avatar icon. Returned for system avatars.
    - `id` string, required — The ID of the avatar.
    - `isDeletable` boolean — Whether the avatar can be deleted.
    - `isSelected` boolean — Whether the avatar is used in Jira. For example, shown as a project's avatar.
    - `isSystemAvatar` boolean — Whether the avatar is a system avatar.
    - `owner` string — The owner of the avatar. For a system avatar the owner is null (and nothing is returned). For non-system avatars this is the appropriate identifier, such as the ID for a project or the account ID for a user.
    - `urls` object — The list of avatar icon URLs.
  - `system` Avatar[] — List of avatars included with Jira. These avatars cannot be deleted.
    - `fileName` string — The file name of the avatar icon. Returned for system avatars.
    - `id` string, required — The ID of the avatar.
    - `isDeletable` boolean — Whether the avatar can be deleted.
    - `isSelected` boolean — Whether the avatar is used in Jira. For example, shown as a project's avatar.
    - `isSystemAvatar` boolean — Whether the avatar is a system avatar.
    - `owner` string — The owner of the avatar. For a system avatar the owner is null (and nothing is returned). For non-system avatars this is the appropriate identifier, such as the ID for a project or the account ID for a user.
    - `urls` object — The list of avatar icon URLs.

## Other responses

- `401` — Returned if the authentication credentials are incorrect or missing.
- `404` — Returned if the project is not found or the user does not have permission to view the project.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-2/versions/5a51740d7ab3/schema)