---
title: "Set project property"
method: PUT
path: "/rest/api/3/project/{projectIdOrKey}/properties/{propertyKey}"
tags: ["Project properties"]
---

# Set project property

`PUT /rest/api/3/project/{projectIdOrKey}/properties/{propertyKey}`

Sets the value of the [project property](https://developer.atlassian.com/cloud/jira/platform/storing-data-without-a-database/#a-id-jira-entity-properties-a-jira-entity-properties). You can use project properties to store custom data against the project.

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:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) or *Administer Projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project in which the property is created.

## Path parameters

- `projectIdOrKey` string, required
- `propertyKey` string, required

## Request body

- unknown

## Response `200`

Returned if the project property is updated.

- unknown

## Other responses

- `201` — Returned if the project property is created.
- `400` — Returned if the project key or id is invalid.
- `401` — Returned if the authentication credentials are incorrect.
- `403` — Returned if the user does not have permission to administer the project.
- `404` — Returned if the project is not found.

---

[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/2783f5d3849c/schema)