---
title: "Choose one provider-advertised session configuration value"
method: PATCH
path: "/api/v1/sessions/{sessionId}/conversation/config-options/{configId}"
tags: ["conversations"]
---

# Choose one provider-advertised session configuration value

`PATCH /api/v1/sessions/{sessionId}/conversation/config-options/{configId}`

## Path parameters

- `sessionId` string, required — Session identifier, e.g. project-1.
- `configId` string, required — Provider session configuration option identifier.

## Request body

- SetConversationConfigOptionRequest
  - `enabled` boolean, nullable
  - `value` string

## Response `200`

OK

- ConversationConfigOptionsResponse
  - `options` ConversationConfigOptionResponse[], required
    - `category` string
    - `choices` ConversationConfigChoiceResponse[]
      - `description` string
      - `group` string
      - `groupName` string
      - `name` string, required
      - `permissionMode` 'default' | 'accept-edits' | 'auto' | 'bypass-permissions'
      - `value` string, required
    - `currentBoolean` boolean, nullable
    - `currentValue` string
    - `description` string
    - `id` string, required
    - `name` string, required
    - `type` 'select' | 'boolean', required

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `409` — Conflict
- `500` — Internal Server Error
- `501` — Not Implemented

## Changes

- **2026-09-06** `79a8e3818e09` — 1 info
  - added the optional property `options/items/choices/items/permissionMode` to the response with the `200` status
- **2026-09-03** `d31a2d019c47` — 5 info
  - added the optional property `reporting_owner` to the response with the `400` status
  - added the optional property `reporting_owner` to the response with the `404` status
  - added the optional property `reporting_owner` to the response with the `409` status
  - added the optional property `reporting_owner` to the response with the `500` status
  - …1 more
- **2026-08-06** `d8396ad2c721` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/changes/api/v1/sessions/:sessionId/conversation/config-options/:configId/patch.md)

---

[API](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon.md) · [All operations](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/llms.txt) · [OpenAPI document](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/revisions/de028b418eb4?raw)