---
title: "Set issue property"
method: PUT
path: "/rest/api/3/issue/{issueIdOrKey}/properties/{propertyKey}"
tags: ["Issue properties"]
---

# Set issue property

`PUT /rest/api/3/issue/{issueIdOrKey}/properties/{propertyKey}`

Sets the value of an issue's property. Use this resource to store custom data against an issue.

The value of the request body must be a [valid](http://tools.ietf.org/html/rfc4627), non-empty JSON blob. The maximum length is 32768 characters.

This operation can be accessed anonymously.

**[Permissions](#permissions) required:**

 *  *Browse projects* and *Edit issues* [project permissions](https://confluence.atlassian.com/x/yodKLg) for the project containing the issue.
 *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue.

## Path parameters

- `issueIdOrKey` string, required
- `propertyKey` string, required

## Request body

- unknown

## Response `200`

Returned if the issue property is updated.

- unknown

## Other responses

- `201` — Returned if the issue property is created.
- `400` — Returned if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have permission to edit the issue.
- `404` — Returned if the issue is not found or the user does not have permission to view the issue.

---

[API](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3.md) · [All operations](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-3/revisions/bb8ae315642f/schema)