> Documentation index: https://www.gooddata.ai/docs/gooddata-ui/llms.txt lists every page of these docs as Markdown.

# IAlertingManagementDialogContextValue

- Package: [@gooddata/sdk-ui-dashboard](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/index.md)
- Kind: interface
- Stability: alpha
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-ui-dashboard/src/presentation/automations/contexts/AlertingManagementDialogContext.ts

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Sub-context for the alerting management dialog. The connector hydrates this from dashboard state. The management dialog tree reads from this context instead of calling useDashboardSelector directly.

**Signature:**

```typescript
export interface IAlertingManagementDialogContextValue 
```

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [alertingDialogReturnFocusTo?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvaluealertingdialogreturnfocusto) |  | string | **_(ALPHA)_** _(Optional)_ Element ID to return focus to when the alerting dialog closes; from selectAlertingDialogReturnFocusTo, read via useAlertingDialogAccessibility. |
| [automations](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvalueautomations) |  | [IAutomationMetadataObject](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iautomationmetadataobject/index.md)[] | **_(ALPHA)_** Alerts visible in the management dialog, scoped to the current dashboard context. |
| [automationsInvalidationId?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvalueautomationsinvalidationid) |  | number | **_(ALPHA)_** _(Optional)_ Cache-bust counter for the automation list: reset to 0 when a management dialog opens, incremented on invalidation. 0 means nothing has been invalidated since the dialog opened; consumers reload when the value changes and is not 0. |
| [canManageWorkspace](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvaluecanmanageworkspace) |  | boolean | **_(ALPHA)_** Whether the current user may manage the workspace; from selectCanManageWorkspace. Combined with alert ownership to gate edit/delete. |
| [currentUser?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvaluecurrentuser) |  | [IUser](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iuser/index.md) | **_(ALPHA)_** _(Optional)_ The logged-in user; from selectCurrentUser. Used to decide whether the user may edit/delete an alert they didn't create. |
| [dashboardId?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvaluedashboardid) |  | string | **_(ALPHA)_** _(Optional)_ Id of the dashboard the management dialog is rendered on. Used to preselect the dashboard filter in the enhanced automations list. |
| [dashboardTitle?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvaluedashboardtitle) |  | string | **_(ALPHA)_** _(Optional)_ Title of the dashboard the management dialog is rendered on. Used as the label of the preselected dashboard filter in the enhanced automations list. |
| [enableAccessibilityMode](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvalueenableaccessibilitymode) |  | boolean | **_(ALPHA)_** Whether accessibility mode is active (for aria/keyboard focus management). |
| [getInsightByWidgetRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvaluegetinsightbywidgetref) |  | (ref: [ObjRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objref/index.md) \| undefined) => [IInsight](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iinsight/index.md) \| undefined | **_(ALPHA)_** Looks up the insight of an insight widget by the widget's ref; undefined for a non-insight widget. |
| [getWidgetByRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvaluegetwidgetbyref) |  | (ref: [ObjRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objref/index.md) \| undefined) => [IWidget](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iwidget/index.md) \| undefined | **_(ALPHA)_** Looks up a dashboard widget (KPI, insight, rich text, or visualization-switcher) by ref, filtering out non-widget layout containers; bridges identifier↔URI ref mismatches the same way as selectWidgetByRef. |
| [isAlertDialogOpen](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvalueisalertdialogopen) |  | boolean | **_(ALPHA)_** Whether the alert create/edit dialog is currently open (from store UI slice). Used by the management dialog's focus-return logic (refocus when the edit dialog closes). |
| [isEmbedded](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvalueisembedded) |  | boolean | **_(ALPHA)_** Whether the dashboard is rendered in an embedded context. |
| [isLoading](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvalueisloading) |  | boolean | **_(ALPHA)_** True while the automation list is still loading. The automations load only — deliberately narrower than the scheduled-email management context's flag, which also folds in a widget-filters load that has no bearing on a management list. |
| [managementDialogContext](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvaluemanagementdialogcontext) |  | { widgetRef?: [ObjRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objref/index.md); } | **_(ALPHA)_** Widget the management dialog is scoped to, when opened for a single widget rather than the whole dashboard; from selectIsAlertingManagementDialogContext. |

## Methods

| Method | Description |
| --- | --- |
| [pauseAlert(alert)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvaluepausealert) | **_(ALPHA)_** Persists the given alert via the alerts save command; resolves with the saved alert, rejects with the command's error. |
| [resumeAlert(alert)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvalueresumealert) | **_(ALPHA)_** Persists the given alert via the alerts save command; resolves with the saved alert, rejects with the command's error. Functionally identical to [IAlertingManagementDialogContextValue.pauseAlert()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvaluepausealert) — distinguished only by name for call-site clarity. |

## Property details

### IAlertingManagementDialogContextValue.alertingDialogReturnFocusTo

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Element ID to return focus to when the alerting dialog closes; from selectAlertingDialogReturnFocusTo, read via useAlertingDialogAccessibility.

**Signature:**

```typescript
alertingDialogReturnFocusTo?: string;
```

### IAlertingManagementDialogContextValue.automations

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Alerts visible in the management dialog, scoped to the current dashboard context.

**Signature:**

```typescript
automations: IAutomationMetadataObject[];
```

### IAlertingManagementDialogContextValue.automationsInvalidationId

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Cache-bust counter for the automation list: reset to 0 when a management dialog opens, incremented on invalidation. 0 means nothing has been invalidated since the dialog opened; consumers reload when the value changes and is not 0.

**Signature:**

```typescript
automationsInvalidationId?: number;
```

### IAlertingManagementDialogContextValue.canManageWorkspace

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Whether the current user may manage the workspace; from selectCanManageWorkspace. Combined with alert ownership to gate edit/delete.

**Signature:**

```typescript
canManageWorkspace: boolean;
```

### IAlertingManagementDialogContextValue.currentUser

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

The logged-in user; from selectCurrentUser. Used to decide whether the user may edit/delete an alert they didn't create.

**Signature:**

```typescript
currentUser?: IUser;
```

### IAlertingManagementDialogContextValue.dashboardId

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Id of the dashboard the management dialog is rendered on. Used to preselect the dashboard filter in the enhanced automations list.

**Signature:**

```typescript
dashboardId?: string;
```

### IAlertingManagementDialogContextValue.dashboardTitle

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Title of the dashboard the management dialog is rendered on. Used as the label of the preselected dashboard filter in the enhanced automations list.

**Signature:**

```typescript
dashboardTitle?: string;
```

### IAlertingManagementDialogContextValue.enableAccessibilityMode

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Whether accessibility mode is active (for aria/keyboard focus management).

**Signature:**

```typescript
enableAccessibilityMode: boolean;
```

### IAlertingManagementDialogContextValue.getInsightByWidgetRef

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Looks up the insight of an insight widget by the widget's ref; undefined for a non-insight widget.

**Signature:**

```typescript
getInsightByWidgetRef: (ref: ObjRef | undefined) => IInsight | undefined;
```

### IAlertingManagementDialogContextValue.getWidgetByRef

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Looks up a dashboard widget (KPI, insight, rich text, or visualization-switcher) by ref, filtering out non-widget layout containers; bridges identifier↔URI ref mismatches the same way as selectWidgetByRef.

**Signature:**

```typescript
getWidgetByRef: (ref: ObjRef | undefined) => IWidget | undefined;
```

### IAlertingManagementDialogContextValue.isAlertDialogOpen

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Whether the alert create/edit dialog is currently open (from store UI slice). Used by the management dialog's focus-return logic (refocus when the edit dialog closes).

**Signature:**

```typescript
isAlertDialogOpen: boolean;
```

### IAlertingManagementDialogContextValue.isEmbedded

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Whether the dashboard is rendered in an embedded context.

**Signature:**

```typescript
isEmbedded: boolean;
```

### IAlertingManagementDialogContextValue.isLoading

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

True while the automation list is still loading.

The automations load only — deliberately narrower than the scheduled-email management context's flag, which also folds in a widget-filters load that has no bearing on a management list.

**Signature:**

```typescript
isLoading: boolean;
```

### IAlertingManagementDialogContextValue.managementDialogContext

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Widget the management dialog is scoped to, when opened for a single widget rather than the whole dashboard; from selectIsAlertingManagementDialogContext.

**Signature:**

```typescript
managementDialogContext: {
        widgetRef?: ObjRef;
    };
```

## Method details

### IAlertingManagementDialogContextValue.pauseAlert()

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Persists the given alert via the alerts save command; resolves with the saved alert, rejects with the command's error.

**Signature:**

```typescript
pauseAlert(alert: IAutomationMetadataObject): Promise<IAutomationMetadataObject>;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| alert | [IAutomationMetadataObject](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iautomationmetadataobject/index.md) |  |

**Returns:**

Promise&lt;[IAutomationMetadataObject](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iautomationmetadataobject/index.md)&gt;

### IAlertingManagementDialogContextValue.resumeAlert()

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Persists the given alert via the alerts save command; resolves with the saved alert, rejects with the command's error. Functionally identical to [IAlertingManagementDialogContextValue.pauseAlert()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ialertingmanagementdialogcontextvalue/index.md#ialertingmanagementdialogcontextvaluepausealert) — distinguished only by name for call-site clarity.

**Signature:**

```typescript
resumeAlert(alert: IAutomationMetadataObject): Promise<IAutomationMetadataObject>;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| alert | [IAutomationMetadataObject](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iautomationmetadataobject/index.md) |  |

**Returns:**

Promise&lt;[IAutomationMetadataObject](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iautomationmetadataobject/index.md)&gt;