---
title: "Load project avatar"
method: POST
path: "/rest/api/3/project/{projectIdOrKey}/avatar2"
tags: ["Project avatars"]
---

# Load project avatar

`POST /rest/api/3/project/{projectIdOrKey}/avatar2`

Loads an avatar for a project.

Specify the avatar's local file location in the body of the request. Also, include the following headers:

 *  `X-Atlassian-Token: no-check` To prevent XSRF protection blocking the request, for more information see [Special Headers](#special-request-headers).
 *  `Content-Type: image/image type` Valid image types are JPEG, GIF, or PNG.

For example:  
`curl --request POST `

`--user email@example.com:<api_token> `

`--header 'X-Atlassian-Token: no-check' `

`--header 'Content-Type: image/< image_type>' `

`--data-binary "<@/path/to/file/with/your/avatar>" `

`--url 'https://your-domain.atlassian.net/rest/api/3/project/{projectIdOrKey}/avatar2'`

The avatar is cropped to a square. If no crop parameters are specified, the square originates at the top left of the image. The length of the square's sides is set to the smaller of the height or width of the image.

The cropped image is then used to create avatars of 16x16, 24x24, 32x32, and 48x48 in size.

After creating the avatar use [Set project avatar](#api-rest-api-3-project-projectIdOrKey-avatar-put) to set it as the project's displayed avatar.

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

## Path parameters

- `projectIdOrKey` string, required

## Query parameters

- `x` integer
- `y` integer
- `size` integer

## Response `201`

Returned if the request is successful.

- Avatar — Details of an avatar.
  - `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

- `400` — Returned if: * an image isn't included in the request. * the image type is unsupported. * the crop parameters extend the crop area beyond the edge of the image.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have permission to administer the project or an anonymous call is made to the operation.
- `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/ec7f275dfee5/schema)