{
"opencollection": "1.0.0",
"info": {
"name": "Atlassian Admin Account Dashboards API",
"version": "1.0.0"
},
"request": {
"auth": {
"type": "bearer",
"token": "{{bearerToken}}"
}
},
"items": [
{
"info": {
"name": "Dashboards",
"type": "folder"
},
"items": [
{
"info": {
"name": "Atlassian Bulk Edit Dashboards",
"type": "http"
},
"http": {
"method": "PUT",
"url": "https://api.atlassian.com/rest/api/3/dashboard/bulk/edit",
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Bulk edit dashboards. Maximum number of dashboards to be edited at the same time is 100.
**[Permissions](#permissions) required:** None
The dashboards to be updated must be owned by the user, or the user must be an administrator."
},
{
"info": {
"name": "Atlassian Get Available Gadgets",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.atlassian.com/rest/api/3/dashboard/gadgets"
},
"docs": "Gets a list of all available gadgets that can be added to all dashboards.
**[Permissions](#permissions) required:** None."
},
{
"info": {
"name": "Atlassian Search For Dashboards",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.atlassian.com/rest/api/3/dashboard/search",
"params": [
{
"name": "dashboardName",
"value": "",
"type": "query",
"description": "String used to perform a case-insensitive partial match with `name`."
},
{
"name": "accountId",
"value": "",
"type": "query",
"description": "User account ID used to return dashboards with the matching `owner.accountId`. This parameter cannot be used with the `owner` parameter."
},
{
"name": "owner",
"value": "",
"type": "query",
"description": "This parameter is deprecated because of privacy changes. Use `accountId` instead. See the [migration guide](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details. User name used to return dashboards with the matching `owner.name`. This parameter cannot be used with the `accountId` parameter."
},
{
"name": "groupname",
"value": "",
"type": "query",
"description": "As a group's name can change, use of `groupId` is recommended. Group name used to return dashboards that are shared with a group that matches `sharePermissions.group.name`. This parameter cannot be used with the `groupId` parameter."
},
{
"name": "groupId",
"value": "",
"type": "query",
"description": "Group ID used to return dashboards that are shared with a group that matches `sharePermissions.group.groupId`. This parameter cannot be used with the `groupname` parameter."
},
{
"name": "projectId",
"value": "",
"type": "query",
"description": "Project ID used to returns dashboards that are shared with a project that matches `sharePermissions.project.id`."
},
{
"name": "orderBy",
"value": "",
"type": "query",
"description": "[Order](#ordering) the results by a field:\n\n * `description` Sorts by dashboard description. Note that this sort works independently of whether the expand to display the description field is in use.\n * `favourite_count` Sorts by dashboard popularity.\n * `id` Sorts by dashboard ID.\n * `is_favourite` Sorts by whether the dashboard is marked as a favorite.\n * `name` Sorts by dashboard name.\n * `owner` Sorts by dashboard owner name."
},
{
"name": "startAt",
"value": "",
"type": "query",
"description": "The index of the first item to return in a page of results (page offset)."
},
{
"name": "maxResults",
"value": "",
"type": "query",
"description": "The maximum number of items to return per page."
},
{
"name": "status",
"value": "",
"type": "query",
"description": "The status to filter by. It may be active, archived or deleted."
},
{
"name": "expand",
"value": "",
"type": "query",
"description": "Use [expand](#expansion) to include additional information about dashboard in the response. This parameter accepts a comma-separated list. Expand options include:\n\n * `description` Returns the description of the dashboard.\n * `owner` Returns the owner of the dashboard.\n * `viewUrl` Returns the URL that is used to view the dashboard.\n * `favourite` Returns `isFavourite`, an indicator of whether the user has set the dashboard as a favorite.\n * `favouritedCount` Returns `popularity`, a count of how many users have set this dashboard as a favorite.\n * `sharePermissions` Returns details of the share permissions defined for the dashboard.\n * `editPermissions` Returns details of the edit permissions defined for the dashboard.\n * `isWritable` Returns whether the current user has permission to edit the dashboard."
}
]
},
"docs": "Returns a [paginated](#pagination) list of dashboards. This operation is similar to [Get dashboards](#api-rest-api-3-dashboard-get) except that the results can be refined to include dashboards that have specific attributes. For example, dashboards with a particular name. When multiple attributes are specified only filters matching all attributes are returned.
This operation can be accessed anonymously.
**[Permissions](#permissions) required:** The following dashboards that match th"
},
{
"info": {
"name": "Atlassian Get Gadgets",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.atlassian.com/rest/api/3/dashboard/:dashboardId/gadget",
"params": [
{
"name": "dashboardId",
"value": "",
"type": "path",
"description": "The ID of the dashboard."
},
{
"name": "moduleKey",
"value": "",
"type": "query",
"description": "The list of gadgets module keys. To include multiple module keys, separate module keys with ampersand: `moduleKey=key:one&moduleKey=key:two`."
},
{
"name": "uri",
"value": "",
"type": "query",
"description": "The list of gadgets URIs. To include multiple URIs, separate URIs with ampersand: `uri=/rest/example/uri/1&uri=/rest/example/uri/2`."
},
{
"name": "gadgetId",
"value": "",
"type": "query",
"description": "The list of gadgets IDs. To include multiple IDs, separate IDs with ampersand: `gadgetId=10000&gadgetId=10001`."
}
]
},
"docs": "Returns a list of dashboard gadgets on a dashboard.
This operation returns:
* Gadgets from a list of IDs, when `id` is set.
* Gadgets with a module key, when `moduleKey` is set.
* Gadgets from a list of URIs, when `uri` is set.
* All gadgets, when no other parameters are set.
This operation can be accessed anonymously.
**[Permissions](#permissions) required:** None."
},
{
"info": {
"name": "Atlassian Add Gadget To Dashboard",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.atlassian.com/rest/api/3/dashboard/:dashboardId/gadget",
"params": [
{
"name": "dashboardId",
"value": "",
"type": "path",
"description": "The ID of the dashboard."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Adds a gadget to a dashboard.
**[Permissions](#permissions) required:** None."
},
{
"info": {
"name": "Atlassian Update Gadget On Dashboard",
"type": "http"
},
"http": {
"method": "PUT",
"url": "https://api.atlassian.com/rest/api/3/dashboard/:dashboardId/gadget/:gadgetId",
"params": [
{
"name": "dashboardId",
"value": "",
"type": "path",
"description": "The ID of the dashboard."
},
{
"name": "gadgetId",
"value": "",
"type": "path",
"description": "The ID of the gadget."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Changes the title, position, and color of the gadget on a dashboard.
**[Permissions](#permissions) required:** None."
},
{
"info": {
"name": "Atlassian Remove Gadget From Dashboard",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.atlassian.com/rest/api/3/dashboard/:dashboardId/gadget/:gadgetId",
"params": [
{
"name": "dashboardId",
"value": "",
"type": "path",
"description": "The ID of the dashboard."
},
{
"name": "gadgetId",
"value": "",
"type": "path",
"description": "The ID of the gadget."
}
]
},
"docs": "Removes a dashboard gadget from a dashboard.
When a gadget is removed from a dashboard, other gadgets in the same column are moved up to fill the emptied position.
**[Permissions](#permissions) required:** None."
},
{
"info": {
"name": "Atlassian Get Dashboard Item Property Keys",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.atlassian.com/rest/api/3/dashboard/:dashboardId/items/:itemId/properties",
"params": [
{
"name": "dashboardId",
"value": "",
"type": "path",
"description": "The ID of the dashboard."
},
{
"name": "itemId",
"value": "",
"type": "path",
"description": "The ID of the dashboard item."
}
]
},
"docs": "Returns the keys of all properties for a dashboard item.
This operation can be accessed anonymously.
**[Permissions](#permissions) required:** The user must be the owner of the dashboard or have the dashboard shared with them. Note, users with the *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard. The System dashboard is considered to be shared with all other users, and is accessible to anonymous users whe"
},
{
"info": {
"name": "Atlassian Get Dashboard Item Property",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.atlassian.com/rest/api/3/dashboard/:dashboardId/items/:itemId/properties/:propertyKey",
"params": [
{
"name": "dashboardId",
"value": "",
"type": "path",
"description": "The ID of the dashboard."
},
{
"name": "itemId",
"value": "",
"type": "path",
"description": "The ID of the dashboard item."
},
{
"name": "propertyKey",
"value": "",
"type": "path",
"description": "The key of the dashboard item property."
}
]
},
"docs": "Returns the key and value of a dashboard item property.
A dashboard item enables an app to add user-specific information to a user dashboard. Dashboard items are exposed to users as gadgets that users can add to their dashboards. For more information on how users do this, see [Adding and customizing gadgets](https://confluence.atlassian.com/x/7AeiLQ).
When an app creates a dashboard item it registers a callback to receive the dashboard item ID. The callback fires whenever the item "
},
{
"info": {
"name": "Atlassian Set Dashboard Item Property",
"type": "http"
},
"http": {
"method": "PUT",
"url": "https://api.atlassian.com/rest/api/3/dashboard/:dashboardId/items/:itemId/properties/:propertyKey",
"params": [
{
"name": "dashboardId",
"value": "",
"type": "path",
"description": "The ID of the dashboard."
},
{
"name": "itemId",
"value": "",
"type": "path",
"description": "The ID of the dashboard item."
},
{
"name": "propertyKey",
"value": "",
"type": "path",
"description": "The key of the dashboard item property. The maximum length is 255 characters. For dashboard items with a spec URI and no complete module key, if the provided propertyKey is equal to \"config\", the request body's JSON must be an object with all keys and values as strings."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Sets the value of a dashboard item property. Use this resource in apps to store custom data against a dashboard item.
A dashboard item enables an app to add user-specific information to a user dashboard. Dashboard items are exposed to users as gadgets that users can add to their dashboards. For more information on how users do this, see [Adding and customizing gadgets](https://confluence.atlassian.com/x/7AeiLQ).
When an app creates a dashboard item it registers a callback to receiv"
},
{
"info": {
"name": "Atlassian Delete Dashboard Item Property",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.atlassian.com/rest/api/3/dashboard/:dashboardId/items/:itemId/properties/:propertyKey",
"params": [
{
"name": "dashboardId",
"value": "",
"type": "path",
"description": "The ID of the dashboard."
},
{
"name": "itemId",
"value": "",
"type": "path",
"description": "The ID of the dashboard item."
},
{
"name": "propertyKey",
"value": "",
"type": "path",
"description": "The key of the dashboard item property."
}
]
},
"docs": "Deletes a dashboard item property.
This operation can be accessed anonymously.
**[Permissions](#permissions) required:** The user must be the owner of the dashboard. Note, users with the *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard."
},
{
"info": {
"name": "Atlassian Get Dashboard",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.atlassian.com/rest/api/3/dashboard/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the dashboard."
}
]
},
"docs": "Returns a dashboard.
This operation can be accessed anonymously.
**[Permissions](#permissions) required:** None.
However, to get a dashboard, the dashboard must be shared with the user or the user must own it. Note, users with the *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard. The System dashboard is considered to be shared with all other users."
},
{
"info": {
"name": "Atlassian Update Dashboard",
"type": "http"
},
"http": {
"method": "PUT",
"url": "https://api.atlassian.com/rest/api/3/dashboard/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the dashboard to update."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Updates a dashboard, replacing all the dashboard details with those provided.
**[Permissions](#permissions) required:** None
The dashboard to be updated must be owned by the user."
},
{
"info": {
"name": "Atlassian Delete Dashboard",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.atlassian.com/rest/api/3/dashboard/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the dashboard."
}
]
},
"docs": "Deletes a dashboard.
**[Permissions](#permissions) required:** None
The dashboard to be deleted must be owned by the user."
},
{
"info": {
"name": "Atlassian Copy Dashboard",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.atlassian.com/rest/api/3/dashboard/:id/copy",
"params": [
{
"name": "id",
"value": "",
"type": "path"
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Copies a dashboard. Any values provided in the `dashboard` parameter replace those in the copied dashboard.
**[Permissions](#permissions) required:** None
The dashboard to be copied must be owned by or shared with the user."
},
{
"info": {
"name": "Atlassian Get All Dashboards",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.atlassian.com/rest/api/3/dashboard",
"params": [
{
"name": "filter",
"value": "",
"type": "query",
"description": "The filter applied to the list of dashboards. Valid values are:\n\n * `favourite` Returns dashboards the user has marked as favorite.\n * `my` Returns dashboards owned by the user."
},
{
"name": "startAt",
"value": "",
"type": "query",
"description": "The index of the first item to return in a page of results (page offset)."
},
{
"name": "maxResults",
"value": "",
"type": "query",
"description": "The maximum number of items to return per page."
}
]
},
"docs": "Returns a list of dashboards owned by or shared with the user. The list may be filtered to include only favorite or owned dashboards.
This operation can be accessed anonymously.
**[Permissions](#permissions) required:** None."
},
{
"info": {
"name": "Atlassian Create Dashboard",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.atlassian.com/rest/api/3/dashboard",
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Creates a dashboard.
**[Permissions](#permissions) required:** None."
}
]
}
],
"bundled": true
}