Sign in

v4

OpenAPI 3.0.1Apache 2.02026-08-016169702.3 MB
UI modifications (apps)

Update UI modification

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 required:

  • None if the UI modification is created without contexts.
  • Browse projects project permission 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.

put/rest/api/3/uiModifications/{uiModificationId}

Path parameters

uiModificationIdstring required

The ID of the UI modification.

Request body

datastring

The data of the UI modification. The maximum size of the data is 50000 characters.

descriptionstring

The description of the UI modification. The maximum length is 255 characters.

namestring

The name of the UI modification. The maximum length is 255 characters.

Response

Returned if the UI modification is updated.

{"stackTrail":"paths:/rest/api/3/uiModifications/{uiModificationId}:put:responses:204:content:application/json:schema","oasType":"schema","type":"unknown"}