> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SessionConfigs

> `composio.sessionConfigs` — saved, reusable Session configs.  A Session config is a named access policy (`sc_…`) built in the Composio Dashboard under Sessions → Configs. Pass its id as `experimental.sessionConfigId` to `composio.sessions.create()` or `session.update()` to apply it.  These endpoints require Session configs to be enabled for the project; otherwise the backend returns 403.

## Usage

Access this class through the `composio.sessionConfigs` property:

```typescript theme={null}
const composio = new Composio({ apiKey: 'your-api-key' });
const result = await composio.sessionConfigs.list();
```

## Methods

### get()

Retrieve one saved Session config with its description and access policy. A missing or cross-project id surfaces as the backend's 404.

Requires Session configs to be enabled for the project.

```typescript theme={null}
async get(id: string, requestOptions?: ComposioRequestOptions): Promise<SessionConfig>
```

**Parameters**

| Name | Type | Description |
| - | - | - |
| `id` | `string` | The `sc_…` id of the Session config |
| `requestOptions?` | `ComposioRequestOptions` | |

**Returns**

`Promise<SessionConfig>` — The config and its policy

**Example**

```typescript theme={null}
const sessionConfig = await composio.sessionConfigs.get('sc_abc123');
console.log(sessionConfig.config.toolkits);
```

***

### list()

List the project's saved Session configs with cursor pagination.

Omitting `archived` returns active configs; `archived: true` returns only archived ones. The backend defaults `limit` to 20 and caps it at 100.

Requires Session configs to be enabled for the project.

```typescript theme={null}
async list(params?: SessionConfigListParams, requestOptions?: ComposioRequestOptions): Promise<SessionConfigListResponse>
```

**Parameters**

| Name | Type | Description |
| - | - | - |
| `params?` | `SessionConfigListParams` | `archived`, `limit` and `cursor`; the deprecated `search` is ignored |
| `requestOptions?` | `ComposioRequestOptions` | |

**Returns**

`Promise<SessionConfigListResponse>` — Config summaries and the next cursor

**Example**

```typescript theme={null}
let cursor: string | undefined;
do {
  const page = await composio.sessionConfigs.list({ cursor });
  for (const item of page.items) console.log(item.id, item.name);
  cursor = page.nextCursor ?? undefined;
} while (cursor);
```

***
