---
title: "Set user property"
method: PUT
path: "/rest/api/2/user/properties/{propertyKey}"
tags: ["User properties"]
---

# Set user property

`PUT /rest/api/2/user/properties/{propertyKey}`

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

Note: This operation does not access the [user properties](https://confluence.atlassian.com/x/8YxjL) created and maintained in Jira.

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

 *  *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg), to set a property on any user.
 *  Access to Jira, to set a property on the calling user's record.

## Path parameters

- `propertyKey` string, required

## Query parameters

- `accountId` string
- `userKey` string
- `username` string

## Request body

- unknown

## Response `200`

Returned if the user property is updated.

- unknown

## Other responses

- `201` — Returned if the user property is created.
- `400` — Returned if `accountId` is missing.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have the necessary permission or is not accessing their user record.
- `404` — Returned if the user is not found.
- `405` — Returned if the property key is not specified.

---

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