---
canonical_url: "https://docs.composio.dev/reference/api-reference/tool-router/getSessionConfigs"
markdown_url: "https://docs.composio.dev/reference/api-reference/tool-router/getSessionConfigs.md"
product: "platform"
version: "3.1"
last_updated: null
---

# List Session configs

**Documentation:** /reference/api-reference/tool-router/getSessionConfigs

> **API version:** This page documents Composio REST API v3.1, the current version, at `https://backend.composio.dev/api/v3.1`. `https://backend.composio.dev/api/v3` is the previous version and remains supported.

List Session configs in your project, newest updated first. Returns active configs by default; set archived=true to list archived configs. Retrieve a config by ID for its description and toolkit, tool, and tag policy. Experimental: available only to projects enabled for Session configs. Create and manage configs in Dashboard.

---

## GET `/api/v3.1/session_configs`

**Endpoint:** `https://backend.composio.dev/api/v3.1/session_configs`

**Summary:** List Session configs

List Session configs in your project, newest updated first. Returns active configs by default; set archived=true to list archived configs. Retrieve a config by ID for its description and toolkit, tool, and tag policy. Experimental: available only to projects enabled for Session configs. Create and manage configs in Dashboard.

### Authentication

**ApiKeyAuth** - API Key in `header` header `x-api-key`

### Query Parameters

- `cursor` (string): Opaque cursor from the previous page.
- `limit` (integer): Maximum number of configs to return, from 1 to 100.
- `search` (string): Case-insensitive substring match against the config name.
- `archived` (boolean,null): Return archived configs when true. Defaults to active configs only.

### Responses

#### 200 - Session configs listed.

**Response Schema:**

- `items` (array<object>) *(required)*: Config summaries. Retrieve a config by ID for its description and access policy.
  - Array items:
    - `id` (string (sessionConfigId)) *(required)*: Stable public identifier of the Session config.
    - `name` (string) *(required)*: Project-unique display name.
    - `archived` (boolean) *(required)*: Whether the config is archived.
    - `created_at` (string (date-time)) *(required)*: Creation time in ISO 8601.
    - `updated_at` (string (date-time)) *(required)*: Last update time in ISO 8601.
- `next_cursor` (string,null) *(required)*: Opaque cursor for the next page, or null when there are no more results.

**Example Response:**

```json
{
  "items": [
    {
      "id": "string",
      "name": "string",
      "archived": true,
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ],
  "next_cursor": null
}
```

#### 400 - Invalid filter or pagination cursor.

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 401 - Unauthorized.

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 403 - Session configs or read access not enabled for this project.

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 404 - Project not found.

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 500 - Internal server error.

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

### Example cURL Request

```bash
curl -X GET "https://backend.composio.dev/api/v3.1/session_configs" \
  -H "x-api-key: YOUR_API_KEY"
```

---

## REST API version

The current REST API version is **v3.1**, served at `https://backend.composio.dev/api/v3.1`. Prefer it for new code and new examples.

`https://backend.composio.dev/api/v3` is the previous version. It is frozen with pinned tool-version defaults and remains supported — existing v3 integrations keep working and do not need to migrate.