---
title: "Set project feature state"
method: PUT
path: "/rest/api/3/project/{projectIdOrKey}/features/{featureKey}"
tags: ["Project features"]
---

# Set project feature state

`PUT /rest/api/3/project/{projectIdOrKey}/features/{featureKey}`

Sets the state of a project feature.

## Path parameters

- `projectIdOrKey` string, required
- `featureKey` string, required

## Request body

- ProjectFeatureState — Details of the feature state.
  - `state` 'ENABLED' | 'DISABLED' | 'COMING_SOON' — The feature state.

## Response `200`

Returned if the request is successful.

- ContainerForProjectFeatures — The list of features on a project.
  - `features` ProjectFeature[] — The project features.
    - `feature` string — The key of the feature.
    - `imageUri` string — URI for the image representing the feature.
    - `localisedDescription` string — Localized display description for the feature.
    - `localisedName` string — Localized display name for the feature.
    - `prerequisites` string[] — List of keys of the features required to enable the feature.
    - `projectId` integer — The ID of the project.
    - `state` 'ENABLED' | 'DISABLED' | 'COMING_SOON' — The state of the feature. When updating the state of a feature, only ENABLED and DISABLED are supported. Responses can contain all values
    - `toggleLocked` boolean — Whether the state of the feature can be updated.

## Other responses

- `400` — Returned if the request is not valid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have the required permissions.
- `404` — Returned if the project or project feature 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/7b92e6a64584/schema)