---
title: "Set property"
method: PUT
path: "/rest/servicedeskapi/organization/{organizationId}/property/{propertyKey}"
tags: ["Organization"]
---

# Set property

`PUT /rest/servicedeskapi/organization/{organizationId}/property/{propertyKey}`

## Request

- Base URL: `https://your-domain.atlassian.net`
- URL: `https://your-domain.atlassian.net/rest/servicedeskapi/organization/{organizationId}/property/{propertyKey}`
- Auth: OAuth 2
  - Authorization code: `https://auth.atlassian.com/authorize`
  - Token URL: `https://auth.atlassian.com/oauth/token` scopes: `manage:servicedesk-customer`

Sets the value of an organization property. Use this resource to store custom data against an organization. Organization properties are a type of entity property which are available to the API only, and not shown in Jira Service Management. [Learn more](https://developer.atlassian.com/cloud/jira/platform/jira-entity-properties/).

To store organization detail field values which are visible in Jira Service Management, see the [Customer Service Management REST API](https://developer.atlassian.com/cloud/customer-service-management/rest/v1/api-group-organization/#api-group-organization).

**[Permissions](#permissions) required**: Service Desk Administrator or Agent.

Note: Permission to manage organizations can be switched to users with the Jira administrator permission, using the **[Organization management](https://confluence.atlassian.com/servicedeskcloud/setting-up-service-desk-users-732528877.html#Settingupservicedeskusers-manageorgsManageorganizations)** feature.

## Path parameters

- `organizationId` string, required
- `propertyKey` string, required

## Request body

- unknown

## Response `200`

Returned if the organization property was updated.

- unknown

## Other responses

- `201`: Returned if the organization property was created.
- `400`: Returned if the organization ID is invalid.
- `401`: Returned if the user is not logged in.
- `403`: Returned if the user does not have permission to complete this request.
- `404`: Returned if the organization does not exist.
- `500`: Internal Server Error.

## Changes

> 20 revisions in range; 3 not diffed.

- **2026-07-13** `bba7b3477d98`: 1 breaking, 50 warning
  - the request's body type changed from `object` to no type
  - removed the request property `asyncContext`
  - removed the request property `asyncStarted`
  - removed the request property `asyncSupported`
  - …47 more
- **2024-02-08** `7c79c3ffe305`: 1 breaking
  - added required request body

[Operation history](https://skmtc.dev/atlassian/apis/service-management-public-rest-api/changes/rest/servicedeskapi/organization/:organizationId/property/:propertyKey/put.md)

---

[API](https://skmtc.dev/atlassian/apis/service-management-public-rest-api.md) - [All operations](https://skmtc.dev/atlassian/apis/service-management-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/service-management-public-rest-api/revisions/fe02b1260fc7?raw)