---
title: "List all workspaces"
slug: "list-all-company-workspaces-v2workspaces"
updated: 2025-11-17T08:10:53Z
published: 2025-11-17T08:12:09Z
---

> ## 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.

# List all company workspaces (/v2/workspaces)

Get/v2/workspaces

Returns a list of all workspaces including their details.

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

Responses200

Successful response

<select class='api-response-data' aria-label='Media type'><option value='5302d542-abac-407c-815e-c5d3bafc7c0e'>application/json</option>
</select>Expand Allobject  requestIdstring    

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

Example4al018gzaztcr8nbukw
workspaces Array of object (WorkspaceMetadata)   

A list, in which each item provides a workspace metadata.

object  

A list, in which each item provides a workspace metadata.

idstring    

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

Example623457276584334
namestring    

The name of the workspace.

ExampleSome Workspace
descriptionstring    

The description of the workspace.

ExampleThis is one of our workspaces

400

Malformed request

<select class='api-response-data' aria-label='Media type'><option value='5c110ab2-5445-4ccb-89af-99c84b0f152e'>application/json</option>
</select>object  requestIdstring    

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    

403

Access denied

<select class='api-response-data' aria-label='Media type'><option value='a39d809e-845f-4963-9900-f1bbc64bcb1c'>application/json</option>
</select>object  requestIdstring    

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

HeadersRetry-AfterintegerNumber of seconds to wait before making a new request.
<select class='api-response-data' aria-label='Media type'><option value='5d7c6629-9fb5-4a97-a730-196639b6d15b'>application/json</option>
</select>object  requestIdstring    

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

<select class='api-response-data' aria-label='Media type'><option value='07eea506-d1d7-435e-a58b-75954ed891bb'>application/json</option>
</select>object  requestIdstring    

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