Jira

Jira Avatars API

This resource represents system and custom avatars. Use it to obtain the details of system or custom avatars, add and remove avatars from a project, issue type or priority and obtain avatar images.

GitHub OpenAPI

Operations 7

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /rest/api/3/avatar/{type}/system List built-in system avatars by type · Get system avatars by type #
Ask an LLM
“Which built-in avatars does Jira ship for projects, users or priorities?”
“Can I browse the stock system icons for issue types?”
Tell an agent
List the system avatars for type {type}.
Show Jira's stock {type} avatars.
GET /rest/api/3/universal_avatar/type/{type}/owner/{entityId} List system and custom avatars for an item · Get avatars #
Ask an LLM
“What avatars, including custom uploads, are available for a specific project?”
“Which icons could I pick for a given issue type or priority?”
Tell an agent
List the avatars available for {type} {entityId}.
Show both system and custom avatars I can use for {type} {entityId}.
POST /rest/api/3/universal_avatar/type/{type}/owner/{entityId} Upload a custom avatar for a project, issue type or priority · Load avatar #
Ask an LLM
“How do I upload a custom avatar image for a project or priority?”
“Can I crop an uploaded avatar to a square region?”
Tell an agent
Upload this image as a custom avatar for {type} {entityId} cropped to {size}.
Load a {type} avatar for {entityId}, cropping a {size} square starting at x {x}, y {y}.
DELETE /rest/api/3/universal_avatar/type/{type}/owner/{owningObjectId}/avatar/{id} Delete a custom avatar · Delete avatar #
Ask an LLM
“How do I remove a custom avatar from a project or issue type?”
“Who is allowed to delete an uploaded avatar?”
Tell an agent destructive · confirm first
Delete avatar {id} from {type} {owningObjectId}.
Remove the uploaded {type} avatar {id} belonging to {owningObjectId}.
GET /rest/api/3/universal_avatar/view/type/{type} Get the default avatar image for a type · Get avatar image by type #
Ask an LLM
“Where can I download the default image used for new projects or priorities?”
“Can I get the default avatar image in a particular size or format?”
Tell an agent
Download the default {type} avatar image.
Get the default {type} avatar as {format} at size {size}.
GET /rest/api/3/universal_avatar/view/type/{type}/avatar/{id} Download an avatar image by its ID · Get avatar image by ID #
Ask an LLM
“How do I fetch the actual image file for a known avatar ID?”
“Can I request an avatar image as PNG instead of its original format?”
Tell an agent
Download {type} avatar image {id}.
Get avatar {id} of type {type} rendered as {format}.
GET /rest/api/3/universal_avatar/view/type/{type}/owner/{entityId} Download the current avatar image of an item · Get avatar image by owner #
Ask an LLM
“What image is a particular project currently using as its avatar?”
“Can I pull the icon a specific issue type displays right now?”
Tell an agent
Download the current avatar image of {type} {entityId}.
Get the icon {type} {entityId} is showing, at size {size}.

Documentation

📖
Documentation
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
📖
Authentication
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
📖
Documentation
https://developer.atlassian.com/cloud/jira/software/rest/intro/
📖
Documentation
https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
📖
APIReference
https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-avatars-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/jira:jira-avatars-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

jira-avatars-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: ecosystem@atlassian.com
  description: Jira Cloud platform REST API documentation
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: https://developer.atlassian.com/platform/marketplace/atlassian-developer-terms/
  title: Jira Cloud platform REST Avatars API
  version: 1001.0.0-SNAPSHOT-82b018affa468e58f284fbe4df33536469d757df
servers:
- url: https://your-domain.atlassian.net
tags:


# --- truncated at 32 KB (53 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-avatars-api-openapi.yml