---
title: "PATCH /api/v1/agent-vault/settings/session-logs"
method: PATCH
path: "/api/v1/agent-vault/settings/session-logs"
tags: ["Agent Vault Settings"]
---

# PATCH /api/v1/agent-vault/settings/session-logs

`PATCH /api/v1/agent-vault/settings/session-logs`

Updates the session log settings

## Request body

- object
  - `enabled` boolean — Whether session logs are on. Turning them off stops recording but keeps what's already recorded.
  - `appConnectionId` string, uuid, nullable — The ID of the AWS connection Infisical uses to write to and read from the bucket.
  - `bucket` string — The name of the S3 bucket. 3 to 63 characters: lowercase letters, numbers, dots and hyphens, starting and ending with a letter or number.
  - `region` 'us-east-1' | 'us-east-2' | 'us-west-1' | 'us-west-2' | 'us-gov-east-1' | 'us-gov-west-1' | 'af-south-1' | 'ap-east-1' | 'ap-south-1' | 'ap-south-2' | 'ap-northeast-1' | 'ap-northeast-2' | 'ap-northeast-3' | 'ap-southeast-1' | 'ap-southeast-2' | 'ap-southeast-3' | 'ap-southeast-4' | 'ca-central-1' | 'eu-central-1' | 'eu-central-2' | 'eu-west-1' | 'eu-west-2' | 'eu-west-3' | 'eu-south-1' | 'eu-south-2' | 'eu-north-1' | 'me-south-1' | 'me-central-1' | 'sa-east-1' — The AWS region of the bucket.
  - `keyPrefix` string — The folder in the bucket to store session logs in, such as `logs/agent-vault`. Up to 512 characters: letters, numbers and `! - _ . ' ( ) /`, with no slash at the start or end, no empty folder name, and no folder named `.` or `..`.

## Response `200`

Default Response

- object
  - `settings` object, required
    - `enabled` boolean, required — Whether session logs are on. Turning them off stops recording but keeps what's already recorded.
    - `appConnectionId` string, uuid, nullable, required — The ID of the AWS connection Infisical uses to write to and read from the bucket.
    - `bucket` string, nullable, required — The name of the S3 bucket. 3 to 63 characters: lowercase letters, numbers, dots and hyphens, starting and ending with a letter or number.
    - `region` string, nullable, required — The AWS region of the bucket.
    - `keyPrefix` string, nullable, required — The folder in the bucket to store session logs in, such as `logs/agent-vault`. Up to 512 characters: letters, numbers and `! - _ . ' ( ) /`, with no slash at the start or end, no empty folder name, and no folder named `.` or `..`.

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `422` — Default Response
- `500` — Default Response

## Changes

- **2026-09-30** `b1861c910818` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/infisical/apis/infisical-api/changes/api/v1/agent-vault/settings/session-logs/patch.md)

---

[API](https://skmtc.dev/infisical/apis/infisical-api.md) · [All operations](https://skmtc.dev/infisical/apis/infisical-api/llms.txt) · [OpenAPI document](https://skmtc.dev/infisical/apis/infisical-api/revisions/8d8e9d059648?raw)