---
title: "List Session configs"
method: GET
path: "/api/v3.1/session_configs"
tags: ["Tool Router"]
---

# List Session configs

`GET /api/v3.1/session_configs`

## Request

- Base URL: `https://backend.composio.dev`
- URL: `https://backend.composio.dev/api/v3.1/session_configs`
- Auth: API key in header `x-api-key`

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.

## Query parameters

- `cursor` string: Opaque cursor from the previous page.
- `limit` integer: Maximum number of configs to return, from 1 to 100.
- `archived` boolean, nullable: Return archived configs when true. Defaults to active configs only.

## Response `200`

Session configs listed.

- object
  - `items` object[], required: Config summaries. Retrieve a config by ID for its description and access policy.
    - `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, nullable, required: Opaque cursor for the next page, or null when there are no more results.

## Other responses

- `400`: Invalid filter or pagination cursor.
- `401`: Unauthorized.
- `403`: Session configs or read access not enabled for this project.
- `404`: Project not found.
- `500`: Internal server error.

## Changes

- **2026-10-23** `4bd56a0836f8`: 1 warning
  - deleted the `query` request parameter `search`
- **2026-10-16** `98956f31abf3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/composiohq/apis/composio-platform-api-v3-1/changes/api/v3.1/session_configs/get.md)

---

[API](https://skmtc.dev/composiohq/apis/composio-platform-api-v3-1.md) - [All operations](https://skmtc.dev/composiohq/apis/composio-platform-api-v3-1/llms.txt) - [OpenAPI document](https://skmtc.dev/composiohq/apis/composio-platform-api-v3-1/revisions/4bd56a0836f8?raw)