Jira

Jira Issue properties API

This resource represents [issue](#api-group-Issues) properties, which provides for storing custom data against an issue. Use it to get, set, and delete issue properties as well as obtain details of all properties on an issue. Operations to bulk update and delete issue properties are also provided. Issue properties are a type of [entity property](https://developer.atlassian.com/cloud/jira/platform/jira-entity-properties/).

GitHub OpenAPI

Operations 8

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

POST /rest/api/3/issue/properties Set the same properties on many issues · Bulk set issues properties by list #
Ask an LLM
“Can I apply one list of entity properties to thousands of issues in one request?”
“How many properties and issues can a single bulk property list update cover?”
Tell an agent
Set properties {properties} on issues {entitiesIds}.
Apply the same property list {properties} across issues {entitiesIds} in one go.
POST /rest/api/3/issue/properties/multi Set different properties per issue in bulk · Bulk set issue properties by issue #
Ask an LLM
“How do I give each issue its own property values in a single async request?”
“What's the limit on issues when setting per-issue property values in bulk?”
Tell an agent
Set these per-issue property values: {issues}.
Write a different set of properties to each issue in {issues} as a background task.
DELETE /rest/api/3/issue/properties/{propertyKey} Delete one property from many issues · Bulk delete issue property #
Ask an LLM
“How do I strip a property off lots of issues at once?”
“Can I bulk delete a property only where it currently has a certain value?”
Tell an agent destructive · confirm first
Delete property {propertyKey} from issues {entityIds}.
Remove property {propertyKey} from every issue where it equals {currentValue}.
PUT /rest/api/3/issue/properties/{propertyKey} Set one property across many issues · Bulk set issue property #
Ask an LLM
“Can I set a single property key on every issue that matches a filter?”
“Is it possible to compute a property's value with a Jira expression for each issue?”
Tell an agent
Set property {propertyKey} to {value} on issues matching {filter}.
Set property {propertyKey} on many issues using expression {expression}.
GET /rest/api/3/issue/{issueIdOrKey}/properties List property keys on an issue · Get issue property keys #
Ask an LLM
“What custom property keys are stored on an issue?”
“Which apps have saved data against a particular issue?”
Tell an agent
List the property keys on issue {issueIdOrKey}.
Show every entity property key attached to {issueIdOrKey}.
DELETE /rest/api/3/issue/{issueIdOrKey}/properties/{propertyKey} Delete a property from a single issue · Delete issue property #
Ask an LLM
“How do I remove one custom property from a single issue?”
“Which permissions do I need to delete an issue's property?”
Tell an agent destructive · confirm first
Delete property {propertyKey} from issue {issueIdOrKey}.
Clear the {propertyKey} data stored on {issueIdOrKey} only.
GET /rest/api/3/issue/{issueIdOrKey}/properties/{propertyKey} Read one property of an issue · Get issue property #
Ask an LLM
“What value is stored under a given property key on one issue?”
“Can I read an issue's property if issue-level security applies?”
Tell an agent
Get property {propertyKey} of issue {issueIdOrKey}.
Read the {propertyKey} value saved on {issueIdOrKey}.
PUT /rest/api/3/issue/{issueIdOrKey}/properties/{propertyKey} Set a property on a single issue · Set issue property #
Ask an LLM
“How do I store custom JSON data against one issue?”
“What's the maximum size of a single issue property value?”
Tell an agent
Set property {propertyKey} on issue {issueIdOrKey} to this JSON.
Save this metadata on {issueIdOrKey} under the key {propertyKey}.

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-issue-properties-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-issue-properties-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-issue-properties-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 Issue properties API
  version: 1001.0.0-SNAPSHOT-82b018affa468e58f284fbe4df33536469d757df
servers:
- url: https://your-domain.atlassian.net
tags:


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