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 Library folders (/v2/library/folders)

  • Updated on Nov 17, 2025
  • Published on Oct 19, 2025
  • 1 minute(s) read
Prev Next
Get
/v2/library/folders

Use this endpoint to retrieve a list of public library folders. We do not allow retrieval of either private or archived folders.

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

Query parameters
workspaceId
string

Workspace identifier. We will retrieve folders which are related to this specific workspace.

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
folders
Array of object (LibraryFolder)

A list, in which each item specifies one folder.

object

Basic details such as sub-folders, title, etc.

id
string

Gong's unique numeric identifier for a library's folder (up to 20 digits).

Example3843152912968920037
name
string

Display name of the folder.

ExampleSales Onboarding
parentFolderId
string

Gong's unique numeric identifier for library's parent folder (null for root folder).

Example295738305212375930
createdBy
string

Gong's unique numeric identifier for the user who added the folder.

Example234599484848423
updated
string (date-time)

Folder's last update time in the ISO-8601 format (e.g., '2020-03-14T05:30:00-08:00').

Example2020-03-14T13:30:00Z
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

No folders found for the specified period

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