Skip to main content

Getting Accessible Workspaces

Description: The operation retrieves the list of workspaces accessible to the current user. This information is required to execute most subsequent queries.

Request parameters:

ParameterTypeFormatDefaultDescription
startintegerint32(empty)Start index for pagination.
totalintegerint32(empty)Maximum number of results to return.
idintegerint64(empty)Optional workspace ID filter.
namestring(empty)Optional workspace name filter.
rolesstring(empty)Optional roles filter.

Example request:

GET
CURL:

curl 'http://localhost:8160/v1/workspaces?start=0&total=1000&id=1&name=ApiEntity&roles=Owner' \
--header 'Api-Token: YOUR_SECRET_TOKEN'

C#:

using System.Text;
var client = new HttpClient();
var request = new HttpRequestMessage
{
Method = HttpMethod.Get,
RequestUri = new Uri("http://localhost:8160/v1/workspaces?start=0&total=1000&id=1&name=ApiEntity&roles=Owner"),
Headers =
{
{ "Api-Token", "YOUR_SECRET_TOKEN" },
},
};
using (var response = await client.SendAsync(request))
{
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
}

Cube:

http://localhost:8160/v1/workspaces?start=0&total=1000&id=&name=&roles=

Additionally:
User-Agent: {-Profile.UserAgent-}
Api-Token: Token from UserArea2.

Response API:

Response codeResult
200 OKOK
401 UnauthorizedUnauthorized
403 ForbiddenForbidden
500 Internal Server ErrorInternal Server Error

Success Response (200 OK):

{
"totalCount": 1,
"items": [
{
"workspaceId": 1,
"name": "Sample Name",
"role": "string"
}
]
}

Error Response (500):

{
"message": null
}