---
title: "Update UI modification"
method: PUT
path: "/rest/api/2/uiModifications/{uiModificationId}"
tags: ["UI modifications (apps)"]
---

# Update UI modification

`PUT /rest/api/2/uiModifications/{uiModificationId}`

Updates a UI modification. UI modification can only be updated by Forge apps.

Each UI modification can define up to 1000 contexts. The same context can be assigned to maximum 100 UI modifications.

**Context types:**

 *  **Jira contexts:** For Jira view types, use `projectId` and `issueTypeId`. One field can act as a wildcard. Supported Jira views:
    
     *  `GIC` \- Jira global issue create
     *  `IssueView` \- Jira issue view
     *  `IssueTransition` \- Jira issue transition
 *  **Jira Service Management contexts:** For Jira Service Management view types, use `portalId` and `requestTypeId`. Wildcards are not supported. Supported JSM views:
    
     *  `JSMRequestCreate` \- Jira Service Management request create portal view

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

 *  *None* if the UI modification is created without contexts.
 *  *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for one or more projects, if the UI modification is created with contexts.

The new `write:app-data:jira` OAuth scope is 100% optional now, and not using it won't break your app. However, we recommend adding it to your app's scope list because we will eventually make it mandatory.

## Path parameters

- `uiModificationId` string, required

## Request body

- UpdateUiModificationDetails — The details of a UI modification.
  - `contexts` UiModificationContextDetails[] — List of contexts of the UI modification. The maximum number of contexts is 1000. If provided, replaces all existing contexts.
    - `id` string — The ID of the UI modification context.
    - `isAvailable` boolean — Whether a context is available. For example, when a project is deleted the context becomes unavailable.
    - `issueTypeId` string — The issue type ID of the context. Null is treated as a wildcard, meaning the UI modification will be applied to all issue types. Each UI modification context can have a maximum of one wildcard.
    - `portalId` string — The portal ID of the context. Only required for Jira Service Management request create portal view (`JSMRequestCreate`).
    - `projectId` string — The project ID of the context. Null is treated as a wildcard, meaning the UI modification will be applied to all projects. Each UI modification context can have a maximum of one wildcard.
    - `requestTypeId` string — The request type ID of the context. Only required for Jira Service Management request create portal view (`JSMRequestCreate`).
    - `viewType` 'GIC' | 'IssueView' | 'IssueTransition' | 'JSMRequestCreate' — The view type of the context. Supported values: * `GIC` \- Jira global issue create * `IssueView` \- Jira issue view * `IssueTransition` \- Jira issue transition * `JSMRequestCreate` \- Jira Service Management request create portal view For Jira view types (`GIC`, `IssueView`, `IssueTransition`), null is treated as a wildcard, meaning the UI modification will be applied to all view types. Each Jira context can have a maximum of one wildcard. Wildcards are not applicable for JSM contexts.
  - `data` string — The data of the UI modification. The maximum size of the data is 50000 characters.
  - `description` string — The description of the UI modification. The maximum length is 255 characters.
  - `name` string — The name of the UI modification. The maximum length is 255 characters.

## Response `204`

Returned if the UI modification is updated.

- unknown

## Other responses

- `400` — Returned if the request is not valid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the request is not from a Forge app.
- `404` — Returned if the UI modification, a project, issue type, portal, or request type in the context are not found.

---

[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)