Skip to main content
POST
List trashed dashboards

Restrictions

Usage

  • Lists trashed dashboards in folders the app_key owner can access: folders they created or that belong to one of their teams, plus all subfolders of those; the account owner and admins can access every folder. Each entry is purged permanently 30 days after deletion.
  • Sort keys are title and deleted_at, at most two and each used once; the default is deleted_at descending.
  • Unlike the other dashboard read endpoints, this one requires the Dashboards Manage permission.

Authorizations

app_key
string
query
required

APP Key created in the Flashduty console under My → APP Key. Send it as the app_key query parameter or in the Fd-App-Key request header. Its effective access is the intersection of the key's permission scope and the creator's current role permissions. Keep it secret.

Body

application/json

List trashed dashboards. Defaults to deleted_at descending.

sort
object[]

Sort keys; only title and deleted_at are accepted here.

Maximum array length: 2
p
integer

Page number, 1-based. Defaults to 1.

Required range: x >= 1
limit
integer

Page size, 1–100. Defaults to 20.

Required range: 1 <= x <= 100

Response

Success

Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.

request_id
string
required

Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

A page of deleted dashboards. Entries older than the 30-day retention window are purged.