> ## 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.

# Retrieve a Session config

> Retrieve a saved access policy in your project. config.toolkits.enable selects toolkit slugs; config.toolkits.disable excludes them; an omitted config.toolkits allows all toolkits. Tool and tag rules further restrict access. This returns the saved policy, not an expanded catalog or an existing Session snapshot. Archived configs remain readable but cannot create new Sessions. Experimental: available only to projects enabled for Session configs. Create and manage configs in Dashboard.



## OpenAPI

````yaml api-reference/openapi.json GET /api/v3.1/session_configs/{session_config_id}
openapi: 3.1.0
info:
  version: 3.1.0
  title: Composio Platform API v3.1
  description: >-
    Composio v3.1 API — all endpoints available under /api/v3.1/. Tool endpoints
    default to the latest tool version.
  contact:
    name: Composio Support
    url: https://composio.dev/support
    email: support@composio.dev
  license:
    name: Proprietary
    url: https://composio.dev/terms
servers:
  - url: https://backend.composio.dev
    description: Composio production API
security:
  - ApiKeyAuth: []
tags:
  - name: Authentication
    description: Authentication related endpoints
    x-group: Authentication
  - name: Auth Configs
    description: Authentication configuration management
    x-group: Auth Configs
  - name: Connected Accounts
    description: Connected account management
    x-group: Connected Accounts
  - name: Logs
    description: Logging and monitoring
    x-group: Logs
  - name: OpenAPI
    description: OpenAPI specification management
    x-group: OpenAPI
  - name: Organization
    description: Organization management
    x-group: Organization
  - name: API Keys
    description: API key management
    x-group: API Keys
  - name: Webhooks
    description: Webhook configuration
    x-group: Webhooks
  - name: Webhook Endpoints
    description: >-
      Per-OAuth-app webhook ingress endpoints. Inbound URLs the provider posts
      to, plus signing secret storage and verification.
    x-group: Webhook Endpoints
  - name: Webhook Subscriptions
    description: >-
      Webhook delivery subscriptions. Outbound URLs Composio posts trigger
      events to, plus signing secret rotation and event-type filters.
    x-group: Webhook Subscriptions
  - name: Team
    description: Team member management
    x-group: Team
  - name: Consumer Skills
    description: Organization-authored Skill management
    x-group: Consumer Skills
  - name: Toolkits
    description: Toolkit and tool management
    x-group: Toolkits
  - name: Tools
    description: Tool execution endpoints
    x-group: Tools
  - name: Triggers
    description: Trigger management and execution
    x-group: Triggers
  - name: Payments
    description: Payment and subscription management
    x-group: Payments
  - name: Billing
    description: Dashboard billing state — usage, subscription, contract (cookie-auth only)
    x-group: Billing
  - name: Compliance
    description: Organization compliance agreements and acceptance state
    x-group: Compliance
  - name: Files
    description: File management
    x-group: Files
  - name: MCP
    description: MCP server management
    x-group: MCP
  - name: MCP Partner
    description: MCP partner management
    x-group: MCP Partner
  - name: Stripe Projects
    description: Stripe Projects provisioning
    x-group: Stripe Projects
  - name: Tool Router
    description: (Labs) Tool router endpoints
    x-group: Sessions (Prev Tool Router)
  - name: Playground
    description: Dashboard playground chat
    x-group: Playground
  - name: Arena
    description: Arena conversations, messages and terms
    x-group: Arena
  - name: Projects
    description: Projects API endpoints.
    x-group: Projects
  - name: Organization Management
    description: Organization Management API endpoints.
    x-group: Organization Management
  - name: Webhook Events
    description: Events delivered by Composio to your registered webhook endpoints
    x-group: Webhook Events
paths:
  /api/v3.1/session_configs/{session_config_id}:
    get:
      tags:
        - Tool Router
      summary: Retrieve a Session config
      description: >-
        Retrieve a saved access policy in your project. config.toolkits.enable
        selects toolkit slugs; config.toolkits.disable excludes them; an omitted
        config.toolkits allows all toolkits. Tool and tag rules further restrict
        access. This returns the saved policy, not an expanded catalog or an
        existing Session snapshot. Archived configs remain readable but cannot
        create new Sessions. Experimental: available only to projects enabled
        for Session configs. Create and manage configs in Dashboard.
      operationId: getSessionConfigsBySessionConfigId
      parameters:
        - schema:
            type: string
            format: sessionConfigId
            description: The Session config ID returned by the list endpoint or Dashboard.
            example: sc_123456789012
          required: true
          name: session_config_id
          in: path
      responses:
        '200':
          description: Session config retrieved.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: sessionConfigId
                    description: Stable public identifier of the Session config.
                  name:
                    type: string
                    description: Project-unique display name.
                  description:
                    type:
                      - string
                      - 'null'
                    description: Optional description of when the config should be used.
                  archived:
                    type: boolean
                    description: Whether the config is archived.
                  config:
                    type: object
                    properties:
                      toolkits:
                        anyOf:
                          - type: object
                            properties:
                              enable:
                                type: array
                                items:
                                  type: string
                              require_approval:
                                type: array
                                items:
                                  type: string
                                description: >-
                                  What in this entry needs the user's approval
                                  before it runs.
                            required:
                              - enable
                            additionalProperties: false
                          - type: object
                            properties:
                              disable:
                                type: array
                                items:
                                  type: string
                              require_approval:
                                type: array
                                items:
                                  type: string
                                description: >-
                                  What in this entry needs the user's approval
                                  before it runs.
                            required:
                              - disable
                            additionalProperties: false
                          - type: object
                            properties:
                              require_approval:
                                type: array
                                items:
                                  type: string
                                description: >-
                                  What in this entry needs the user's approval
                                  before it runs.
                            required:
                              - require_approval
                            additionalProperties: false
                      tools:
                        type: object
                        additionalProperties:
                          anyOf:
                            - type: object
                              properties:
                                enable:
                                  type: array
                                  items:
                                    type: string
                                require_approval:
                                  type: array
                                  items:
                                    type: string
                                  description: >-
                                    What in this entry needs the user's approval
                                    before it runs.
                              required:
                                - enable
                              additionalProperties: false
                            - type: object
                              properties:
                                disable:
                                  type: array
                                  items:
                                    type: string
                                require_approval:
                                  type: array
                                  items:
                                    type: string
                                  description: >-
                                    What in this entry needs the user's approval
                                    before it runs.
                              required:
                                - disable
                              additionalProperties: false
                            - type: object
                              properties:
                                tags:
                                  type: object
                                  properties:
                                    enable:
                                      type: array
                                      items:
                                        type: string
                                        enum:
                                          - readOnlyHint
                                          - createHint
                                          - updateHint
                                          - destructiveHint
                                          - idempotentHint
                                          - openWorldHint
                                    disable:
                                      type: array
                                      items:
                                        type: string
                                        enum:
                                          - readOnlyHint
                                          - createHint
                                          - updateHint
                                          - destructiveHint
                                          - idempotentHint
                                          - openWorldHint
                                    require_approval:
                                      type: array
                                      items:
                                        type: string
                                        enum:
                                          - readOnlyHint
                                          - createHint
                                          - updateHint
                                          - destructiveHint
                                          - idempotentHint
                                          - openWorldHint
                                      description: >-
                                        Tags whose tools need the user's
                                        approval before they run.
                                  additionalProperties: false
                                require_approval:
                                  type: array
                                  items:
                                    type: string
                                  description: >-
                                    What in this entry needs the user's approval
                                    before it runs.
                              required:
                                - tags
                              additionalProperties: false
                            - type: object
                              properties:
                                require_approval:
                                  type: array
                                  items:
                                    type: string
                                  description: >-
                                    What in this entry needs the user's approval
                                    before it runs.
                              required:
                                - require_approval
                              additionalProperties: false
                      tags:
                        type: object
                        properties:
                          enable:
                            type: array
                            items:
                              type: string
                              enum:
                                - readOnlyHint
                                - createHint
                                - updateHint
                                - destructiveHint
                                - idempotentHint
                                - openWorldHint
                          disable:
                            type: array
                            items:
                              type: string
                              enum:
                                - readOnlyHint
                                - createHint
                                - updateHint
                                - destructiveHint
                                - idempotentHint
                                - openWorldHint
                          require_approval:
                            type: array
                            items:
                              type: string
                              enum:
                                - readOnlyHint
                                - createHint
                                - updateHint
                                - destructiveHint
                                - idempotentHint
                                - openWorldHint
                            description: >-
                              Tags whose tools need the user's approval before
                              they run.
                        additionalProperties: false
                    additionalProperties: false
                    description: >-
                      Stored Session access policy using the same enable/disable
                      wire shape accepted on create and update, with any
                      require_approval lists.
                  created_at:
                    type: string
                    format: date-time
                    description: Creation time in ISO 8601.
                  updated_at:
                    type: string
                    format: date-time
                    description: Last update time in ISO 8601.
                required:
                  - id
                  - name
                  - description
                  - archived
                  - config
                  - created_at
                  - updated_at
                x-experimental: true
        '400':
          description: Invalid Session config ID.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Session configs or read access not enabled for this project.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Session config not found in this project.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: number
            slug:
              type: string
            status:
              type: number
            request_id:
              type: string
            suggested_fix:
              type: string
            errors:
              type: array
              items:
                type: string
          required:
            - message
            - code
            - slug
            - status
      required:
        - error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Your Composio project API key. Create or copy it from the Composio
        dashboard.
      x-default: your-project-api-key

````