---
title: "Set property"
method: PUT
path: "/rest/agile/1.0/sprint/{sprintId}/properties/{propertyKey}"
tags: ["Sprint"]
---

# Set property

`PUT /rest/agile/1.0/sprint/{sprintId}/properties/{propertyKey}`

## Request

- Base URL: `https://your-domain.atlassian.net`
- URL: `https://your-domain.atlassian.net/rest/agile/1.0/sprint/{sprintId}/properties/{propertyKey}`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `https://auth.atlassian.com/authorize`
    - Token URL: `https://auth.atlassian.com/oauth/token` scopes: `write:sprint:jira-software`
  - none

Sets the value of the specified sprint's property.

You can use this resource to store a custom data against the sprint identified by the id. The user who stores the data is required to have permissions to modify the sprint.

## Path parameters

- `sprintId` string, required
- `propertyKey` string, required

## Request body

- unknown

## Response `200`

Returned if the sprint property is successfully updated.

- unknown

## Other responses

- `201`: Returned if the sprint property is successfully created.
- `400`: Returned if the sprintId is invalid (negative or not a number).
- `401`: Returned if the calling user is not authenticated.
- `403`: Returned if the calling user does not have permission to edit the sprint
- `404`: Returned if the sprint with given id does not exist.

## Changes

- **2026-07-13** `4e108d54b990`: 1 breaking, 3 info
  - added required request body
  - the endpoint scheme security `basicAuth` was added to the API
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `201`
- **2022-09-25** `ac057c9cf7e5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/atlassian/apis/jira-software-cloud-api/changes/rest/agile/1.0/sprint/:sprintId/properties/:propertyKey/put.md)

---

[API](https://skmtc.dev/atlassian/apis/jira-software-cloud-api.md) - [All operations](https://skmtc.dev/atlassian/apis/jira-software-cloud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/jira-software-cloud-api/revisions/4e108d54b990?raw)