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

# items

> Read access to Modus knowledge-base items.

## Methods

### get()

```typescript
get(uid: string): Promise<object>
```

Retrieve a knowledge-base item by uid.

#### Parameters

<ResponseField name={"uid"} type={"string"} required>
  Item uid.
</ResponseField>

#### Returns

`Promise<object>`

The context item.

### list()

```typescript
list(options?: { pageSize: number; pageToken: string; contextType: string }): Promise<Page<object>>
```

List knowledge-base items.

#### Parameters

<ResponseField name={"options"} type={"{ pageSize: number; pageToken: string; contextType: string }"} />

#### Returns

`Promise<Page<object>>`

A page of context items.

### listValues()

```typescript
listValues(uid: string, contextType: string, contentKeyPath: string, options?: { pageSize: number; pageToken: string }): Promise<Page<ContextValueRow>>
```

List values stored under a content key on a context item.

#### Parameters

<ResponseField name={"uid"} type={"string"} required>
  Item uid.
</ResponseField>

<ResponseField name={"contextType"} type={"string"} required>
  Context type of the item.
</ResponseField>

<ResponseField name={"contentKeyPath"} type={"string"} required>
  Dot path to the value field inside item content.
</ResponseField>

<ResponseField name={"options"} type={"{ pageSize: number; pageToken: string }"} />

#### Returns

`Promise<Page<ContextValueRow>>`

A page of value rows.

### listValuesFor()

```typescript
listValuesFor(item: object, contentKeyPath: string, options?: { pageSize: number; pageToken: string }): Promise<Page<ContextValueRow>>
```

List values for a context item already loaded via `ContextItemsResource.list` or `ContextItemsResource.get`.

#### Parameters

<ResponseField name={"item"} type={"object"} required>
  Context item (uses `item.uid` and `item.contextType`).
</ResponseField>

<ResponseField name={"contentKeyPath"} type={"string"} required>
  Dot path to the value field inside item content.
</ResponseField>

<ResponseField name={"options"} type={"{ pageSize: number; pageToken: string }"} />

#### Returns

`Promise<Page<ContextValueRow>>`

A page of value rows.

### lookup()

```typescript
lookup(options: { contextType: string; dataPath: string[]; contentProjection: JsonObjectInput | object }): Promise<object | undefined>
```

Look up a knowledge-base item by type and data path.

#### Parameters

<ResponseField name={"options"} type={"{ contextType: string; dataPath: string[]; contentProjection: JsonObjectInput |…"} required />

#### Returns

`Promise<object | undefined>`

The matching row, or `undefined` when no item is found (404).