> ## Documentation Index
> Fetch the complete documentation index at: https://www.plain.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# deleteDashboard

> Deletes a dashboard and its widgets. Requires `dashboard:delete`.



**mutation** `deleteDashboard(input: DeleteDashboardInput!): DeleteDashboardOutput!`

## Arguments

**`input`**: `DeleteDashboardInput!` (required)

## Returns

`DeleteDashboardOutput!`

**`deletedDashboardId`**: `ID`

---

**`error`**: `MutationError`

## Examples

```graphql Mutation
mutation DeleteDashboard($input: DeleteDashboardInput!) {
  deleteDashboard(input: $input) {
    deletedDashboardId
    error {
      message
      type
      code
      fields {
        field
        message
        type
      }
    }
  }
}
```

```json Variables
{
  "input": {
    "dashboardId": "id"
  }
}
```

```json Response
{
  "data": {
    "deleteDashboard": {
      "deletedDashboardId": "id",
      "error": {
        "message": "string",
        "type": "VALIDATION",
        "code": "string",
        "fields": [
          {
            "field": "string",
            "message": "string",
            "type": "VALIDATION"
          }
        ]
      }
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.