---
title: "Enables or disables API request logging for troubleshooting."
method: PUT
path: "/v2.1/diagnostics/settings"
tags: ["RequestLogs"]
---

# Enables or disables API request logging for troubleshooting.

`PUT /v2.1/diagnostics/settings`

Enables or disables API request logging for troubleshooting.

When enabled (`apiRequestLogging` is **true**), REST API requests and responses for the user are added to a log. A log can have up to 50 requests/responses and the current number of log entries can be determined by getting the settings. Logging is automatically disabled when the log limit of 50 is reached.

You can call [Diagnostics::getRequestLog
](https://developers.docusign.com/esign-rest-api/reference/Diagnostics/RequestLogs/get) or [Diagnostics::listRequestLogs](https://developers.docusign.com/esign-rest-api/reference/Diagnostics/RequestLogs/list) to download the log files (individually or as a zip file). Call [Diagnostics::deleteRequestLogs
](https://developers.docusign.com/esign-rest-api/reference/Diagnostics/RequestLogs/delete) to clear the log by deleting current entries.

Private information, such as passwords and integrator key information, which is normally located in the call header is omitted from the request/response log.

API request logging only captures requests from the authenticated user. Any call that does not authenticate the user and resolve a userId is not logged.

## Request body

- DiagnosticsSettingsInformation
  - `apiRequestLogging` string — When set to **true**, enables API request logging for the user.
  - `apiRequestLogMaxEntries` string — Specifies the maximum number of API requests to log.
  - `apiRequestLogRemainingEntries` string — Indicates the remaining number of API requests that can be logged.

## Response `200`

Successful response.

## Other responses

- `400` — Error encountered.

---

[API](https://skmtc.dev/docusign/apis/docusign-esignature-rest-api.md) · [All operations](https://skmtc.dev/docusign/apis/docusign-esignature-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/docusign/docusign-esignature-rest-api/revisions/deba7c083bb4/schema)
