Documentation Index

Fetch the complete documentation index at: https://help.gong.io/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve user settings history (/v2/users/{id}/settings-history)

  • Updated on Nov 17, 2025
  • Published on Oct 19, 2025
  • 1 minute(s) read
Prev Next
Get
/v2/users/{id}/settings-history

Retrieve a specific user's settings history.

Required authorizaton scope: 'api:users:read'.

Path parameters
id
stringRequired

Gong's unique numeric identifier for the user (up to 20 digits).

Responses
200

Successful response

Expand All
object
requestId
string

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
userSettingsHistory
Array of object (UserSettingsHistory)

User's settings history.

object

User's settings history.

setting
string

The user capability that was changed

Valid values[ "webConferencesRecorded", "preventWebConferenceRecording", "emailsImported", "preventEmailImport", "active", "nonRecordedMeetingsImported", "gongConnectEnabled", "callsImported", "interviewsRecorded", "preventInterviewRecording" ]
value
boolean

The new value that was set

Exampletrue
time
string

The date and time the action was set, in the ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC).

Example2018-02-19T02:30:00-08:00
400

Malformed request

object
requestId
string

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors
Array of string

Error messages.

Example[ "An error has occurred" ]
string
401

Access denied

object
requestId
string

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors
Array of string

Error messages.

Example[ "An error has occurred" ]
string
404

User not found

object
requestId
string

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors
Array of string

Error messages.

Example[ "An error has occurred" ]
string
429

API request limit exceeded

Headers
Retry-After
integer
Number of seconds to wait before making a new request.
object
requestId
string

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors
Array of string

Error messages.

Example[ "An error has occurred" ]
string
500

Failed to complete the operation due to an unexpected error

object
requestId
string

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors
Array of string

Error messages.

Example[ "An error has occurred" ]
string