Bulk edit dashboards

PUT

/rest/api/3/dashboard/bulk/edit

Bulk edit dashboards. Maximum number of dashboards to be edited at the same time is 100.

Permissions required: None

The dashboards to be updated must be owned by the user, or the user must be an administrator.

Request

Body Params application/json

Examples

Responses

🟢200OK

application/json

Returned if the request is successful.

Body

🟠400Bad Request

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/rest/api/3/dashboard/bulk/edit' \
--header 'Content-Type: application/json' \
--data-raw '{
    "action": "changePermission",
    "entityIds": [
        10001,
        10002
    ],
    "extendAdminPermissions": true,
    "permissionDetails": {
        "editPermissions": [
            {
                "group": {
                    "groupId": "276f955c-63d7-42c8-9520-92d01dca0625",
                    "name": "jira-administrators",
                    "self": "https://your-domain.atlassian.net/rest/api/~ver~/group?groupId=276f955c-63d7-42c8-9520-92d01dca0625"
                },
                "id": 10010,
                "type": "group"
            }
        ],
        "sharePermissions": [
            {
                "id": 10000,
                "type": "global"
            }
        ]
    }
}'

Response Example

200 - Success

{"action":"changePermission","entityErrors":{"10002":{"errorMessages":["Only owner or editors of the dashboard can change permissions."],"errors":{}}}}

Modified at 2025-07-16 07:18:01

Create dashboard

Get available gadgets