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

# IWorkspaceFactsService

- Package: [@gooddata/sdk-backend-spi](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/index.md)
- Kind: interface
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-backend-spi/src/workspace/facts/index.ts

Service for querying additional facts data. If you want to query facts themselves, use catalog [IWorkspaceCatalogFactory](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iworkspacecatalogfactory/index.md)

**Signature:**

```typescript
export interface IWorkspaceFactsService 
```

## Methods

| Method | Description |
| --- | --- |
| [getFact(ref, opts)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iworkspacefactsservice/index.md#iworkspacefactsservicegetfact) | Get information about the given fact |
| [getFactDatasetMeta(ref)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iworkspacefactsservice/index.md#iworkspacefactsservicegetfactdatasetmeta) | Get information about the given fact's dataset |
| [getFactsQuery()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iworkspacefactsservice/index.md#iworkspacefactsservicegetfactsquery) | Facts query factory. |
| [updateFactMeta(updatedFact)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iworkspacefactsservice/index.md#iworkspacefactsserviceupdatefactmeta) | Updates metadata of the fact. |

## Method details

### IWorkspaceFactsService.getFact()

Get information about the given fact

**Signature:**

```typescript
getFact(ref: ObjRef, opts?: {
        include?: ["dataset"];
    }): Promise<IFactMetadataObject>;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| ref | [ObjRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objref/index.md) | ref of the fact |
| opts | { include?: ["dataset"]; } | _(Optional)_ options to include additional data |

**Returns:**

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

promise of metadata object

### IWorkspaceFactsService.getFactDatasetMeta()

Get information about the given fact's dataset

**Signature:**

```typescript
getFactDatasetMeta(ref: ObjRef): Promise<IMetadataObject>;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| ref | [ObjRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objref/index.md) | ref of the fact |

**Returns:**

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

promise of metadata object

### IWorkspaceFactsService.getFactsQuery()

Facts query factory.

**Signature:**

```typescript
getFactsQuery(): IFactsQuery;
```
**Returns:**

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

facts query

### IWorkspaceFactsService.updateFactMeta()

Updates metadata of the fact.

**Signature:**

```typescript
updateFactMeta(updatedFact: Partial<IMetadataObjectBase> & IMetadataObjectIdentity): Promise<IFactMetadataObject>;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| updatedFact | Partial&lt;[IMetadataObjectBase](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.imetadataobjectbase/index.md)&gt; &amp; [IMetadataObjectIdentity](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.imetadataobjectidentity/index.md) | update to apply |

**Returns:**

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