List a Custom Dashboard's Revisions

GET /api/0/organizations/{organization_id_or_slug}/dashboards/{dashboard_id}/revisions/

Return the revision history of an organization's custom dashboard, newest first.

Each edit or restore of the dashboard records a revision holding the dashboard as it was just before the change. Only the 10 most recent revisions are kept. Pass a revision's id to the restore endpoint to roll the dashboard back to it.

Path Parameters

organization_id_or_slug (string)
REQUIRED

The ID or slug of the organization the resource belongs to.

dashboard_id (integer)
REQUIRED

The ID of the dashboard you'd like to retrieve.

Query Parameters:

per_page (integer)

Limit the number of rows to return in the result. Default and maximum allowed is 100.

cursor (string)

A pointer to the last object fetched and its sort order; used to retrieve the next or previous results.

Scopes

<auth_token> requires one of the following scopes:
  • org:admin
  • org:read
  • org:write
Copied
curl https://sentry.io/api/0/organizations/{organization_id_or_slug}/dashboards/{dashboard_id}/revisions/ \
 -H 'Authorization: Bearer <auth_token>'
RESPONSESCHEMA
Copied
[
  {
    "id": "2",
    "title": "Dashboard",
    "dateCreated": "2024-07-17T09:12:44.104915Z",
    "createdBy": {
      "id": "1",
      "name": "Admin",
      "email": "admin@sentry.io",
      "avatarType": "letter_avatar",
      "avatarUrl": null
    },
    "source": "pre-restore"
  },
  {
    "id": "1",
    "title": "Dashboard",
    "dateCreated": "2024-07-16T15:36:46.048343Z",
    "createdBy": {
      "id": "1",
      "name": "Admin",
      "email": "admin@sentry.io",
      "avatarType": "letter_avatar",
      "avatarUrl": null
    },
    "source": "edit"
  }
]
Was this helpful?