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

# IOrganizationAutomationsQuery

- Package: [@gooddata/sdk-backend-spi](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/index.md)
- Kind: interface
- Stability: alpha
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-backend-spi/src/organization/automations/index.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).
> 

Service to query automations across the organization for centralized automation management.

**Signature:**

```typescript
export interface IOrganizationAutomationsQuery 
```

## Methods

| Method | Description |
| --- | --- |
| [query()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md#iorganizationautomationsqueryquery) | **_(ALPHA)_** Starts the organization automations query. |
| [queryAll()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md#iorganizationautomationsqueryqueryall) | **_(ALPHA)_** Starts the organization automations query. |
| [withAuthor(author, filterType)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md#iorganizationautomationsquerywithauthor) | **_(ALPHA)_** Sets author of the automation for the query. |
| [withDashboard(dashboard, filterType)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md#iorganizationautomationsquerywithdashboard) | **_(ALPHA)_** Sets dashboard id for the query. |
| [withExternalRecipient(externalRecipient)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md#iorganizationautomationsquerywithexternalrecipient) | **_(ALPHA)_** Sets external recipient of the automation for the query. |
| [withFilter(filter)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md#iorganizationautomationsquerywithfilter) | **_(ALPHA)_** Sets filter for the query. |
| [withPage(page)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md#iorganizationautomationsquerywithpage) | **_(ALPHA)_** Sets starting page for the query. Backend WILL return no data if the page is greater than total number of pages. Default page: 0 |
| [withRecipient(recipient, filterType)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md#iorganizationautomationsquerywithrecipient) | **_(ALPHA)_** Sets recipient of the automation for the query. |
| [withSize(size)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md#iorganizationautomationsquerywithsize) | **_(ALPHA)_** Sets number of automations to return per page. Default size: 100 |
| [withSorting(sort)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md#iorganizationautomationsquerywithsorting) | **_(ALPHA)_** Sets sorting for the query. |
| [withStatus(status, filterType)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md#iorganizationautomationsquerywithstatus) | **_(ALPHA)_** Sets status of automation results for the query. |
| [withType(type)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md#iorganizationautomationsquerywithtype) | **_(ALPHA)_** Sets type of the automation for the query. |
| [withUser(user)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md#iorganizationautomationsquerywithuser) | **_(ALPHA)_** This filter gets automations if either author or recipient of the automation is the provided user. |
| [withWorkspace(workspace, filterType)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md#iorganizationautomationsquerywithworkspace) | **_(ALPHA)_** Filter automations by workspace IDs for centralized management. |

## Method details

### IOrganizationAutomationsQuery.query()

> **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).
> 

Starts the organization automations query.

**Signature:**

```typescript
query(): Promise<IOrganizationAutomationsQueryResult>;
```
**Returns:**

Promise&lt;[IOrganizationAutomationsQueryResult](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsqueryresult/index.md)&gt;

promise of first page of the results

### IOrganizationAutomationsQuery.queryAll()

> **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).
> 

Starts the organization automations query.

**Signature:**

```typescript
queryAll(): Promise<IAutomationMetadataObject[]>;
```
**Returns:**

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

promise with a list of all automations matching the specified options

### IOrganizationAutomationsQuery.withAuthor()

> **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).
> 

Sets author of the automation for the query.

**Signature:**

```typescript
withAuthor(author: string | undefined, filterType?: AutomationFilterType): IOrganizationAutomationsQuery;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| author | string \| undefined | author of the automation |
| filterType | [AutomationFilterType](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.automationfiltertype/index.md) | _(Optional)_ type of filter behavior ("exact", "include", "exclude") |

**Returns:**

[IOrganizationAutomationsQuery](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md)

organization automations query

### IOrganizationAutomationsQuery.withDashboard()

> **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).
> 

Sets dashboard id for the query.

**Signature:**

```typescript
withDashboard(dashboard: string, filterType?: AutomationFilterType): IOrganizationAutomationsQuery;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| dashboard | string | dashboard id |
| filterType | [AutomationFilterType](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.automationfiltertype/index.md) | _(Optional)_ type of filter behavior ("exact", "include", "exclude") |

**Returns:**

[IOrganizationAutomationsQuery](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md)

organization automations query

### IOrganizationAutomationsQuery.withExternalRecipient()

> **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).
> 

Sets external recipient of the automation for the query.

**Signature:**

```typescript
withExternalRecipient(externalRecipient: string | undefined): IOrganizationAutomationsQuery;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| externalRecipient | string \| undefined | external recipient of the automation |

**Returns:**

[IOrganizationAutomationsQuery](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md)

organization automations query

### IOrganizationAutomationsQuery.withFilter()

> **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).
> 

Sets filter for the query.

**Signature:**

```typescript
withFilter(filter: {
        title?: string;
    }): IOrganizationAutomationsQuery;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| filter | { title?: string; } | filter to apply |

**Returns:**

[IOrganizationAutomationsQuery](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md)

organization automations query

### IOrganizationAutomationsQuery.withPage()

> **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).
> 

Sets starting page for the query. Backend WILL return no data if the page is greater than total number of pages. Default page: 0

**Signature:**

```typescript
withPage(page: number | undefined): IOrganizationAutomationsQuery;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| page | number \| undefined | zero indexed, must be non-negative |

**Returns:**

[IOrganizationAutomationsQuery](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md)

organization automations query

### IOrganizationAutomationsQuery.withRecipient()

> **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).
> 

Sets recipient of the automation for the query.

**Signature:**

```typescript
withRecipient(recipient: string | undefined, filterType?: AutomationFilterType): IOrganizationAutomationsQuery;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| recipient | string \| undefined | recipient of the automation |
| filterType | [AutomationFilterType](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.automationfiltertype/index.md) | _(Optional)_ type of filter behavior ("exact", "include", "exclude") |

**Returns:**

[IOrganizationAutomationsQuery](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md)

organization automations query

### IOrganizationAutomationsQuery.withSize()

> **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).
> 

Sets number of automations to return per page. Default size: 100

**Signature:**

```typescript
withSize(size: number | undefined): IOrganizationAutomationsQuery;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| size | number \| undefined | desired max number of automations per page must be a positive number |

**Returns:**

[IOrganizationAutomationsQuery](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md)

organization automations query

### IOrganizationAutomationsQuery.withSorting()

> **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).
> 

Sets sorting for the query.

**Signature:**

```typescript
withSorting(sort: string[]): IOrganizationAutomationsQuery;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| sort | string[] | Sorting criteria in the format: property,(asc\|desc). Default sort order is ascending. Multiple sort criteria are supported. |

**Returns:**

[IOrganizationAutomationsQuery](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md)

organization automations query

### IOrganizationAutomationsQuery.withStatus()

> **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).
> 

Sets status of automation results for the query.

**Signature:**

```typescript
withStatus(status: string | undefined, filterType?: AutomationFilterType): IOrganizationAutomationsQuery;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| status | string \| undefined | status of the automation result ("SUCCESS" or "FAILED") |
| filterType | [AutomationFilterType](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.automationfiltertype/index.md) | _(Optional)_ type of filter behavior ("exact", "include", "exclude") |

**Returns:**

[IOrganizationAutomationsQuery](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md)

organization automations query

### IOrganizationAutomationsQuery.withType()

> **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).
> 

Sets type of the automation for the query.

**Signature:**

```typescript
withType(type: AutomationType | undefined): IOrganizationAutomationsQuery;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| type | [AutomationType](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.automationtype/index.md) \| undefined | type of the automation, e.g. "schedule" or "trigger" |

**Returns:**

[IOrganizationAutomationsQuery](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md)

organization automations query

### IOrganizationAutomationsQuery.withUser()

> **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).
> 

This filter gets automations if either author or recipient of the automation is the provided user.

**Signature:**

```typescript
withUser(user: string): IOrganizationAutomationsQuery;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| user | string | author or recipient of the automation |

**Returns:**

[IOrganizationAutomationsQuery](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md)

organization automations query

### IOrganizationAutomationsQuery.withWorkspace()

> **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).
> 

Filter automations by workspace IDs for centralized management.

**Signature:**

```typescript
withWorkspace(workspace: string | undefined, filterType?: AutomationFilterType): IOrganizationAutomationsQuery;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| workspace | string \| undefined | workspace ID to filter by |
| filterType | [AutomationFilterType](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.automationfiltertype/index.md) | _(Optional)_ type of filter behavior ("exact", "include", "exclude") |

**Returns:**

[IOrganizationAutomationsQuery](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iorganizationautomationsquery/index.md)

organization automations query