Get Projects (Workspaces)

Retrieves the Projects (formerly Workspaces) for an account.

The result set of the API may be reduced based on the Project View Restrictions.

👍
Use this endpoint to get a workspace ID after migration to Harness
After migration to Harness, you can get the workspace ID for a project by using this endpoint with the name query parameter.
You use the Harness project name (not the Harness project Id value) to retrieve the (Split) workspace ID.
For detailed instructions, see the Retrieving a Workspace ID Using the Harness Project Name section in the Before and After: APIs for Split Admins Postman collection.

Access requirements

The Authorization Bearer (Admin API Key authorizing the request) must have one of the following roles and scopes:

Admin API Key roles accepted

API_ALL_GRANTED
API_ADMIN
API_WORKSPACE_ADMIN

Admin API Key scopes accepted

GLOBAL
WORKSPACE*
ENVIRONMENT*

* The result set of the API may be subject to reduction, restricting access to certain elements, if they are not accessible by the provided API key.

To learn more about Admin API Key roles and scopes, see API keys overview.