Workspaces API
Version: 1.0
List workspaces
GET
/workspace/orgs/{org_id}/workspacesReturns a paginated list of all workspaces that you have a role to access in your organization. For a list of all workspaces regardless of your user role, see the 'Admin' equivalent API.
Request
Responses
200
Successful Response
Response schema
linksPaginationLinks
countinteger
firsturi
(1, 2,083) chars
lasturi
(1, 2,083) chars
nextstring | null
(1, 2,083) chars
previousstring | null
(1, 2,083) chars
totalinteger
resultsarray | array
Any of:
array
array
Example response
{
"links": {
"count": 0,
"first": "string",
"last": "string",
"next": "string",
"previous": "string",
"total": 0
},
"results": [
{
"bounding_box": {
"coordinates": [
[
[
0,
0
]
]
],
"type": "Polygon"
},
"created_at": "2024-07-29T15:51:28.071Z",
"created_by": {
"email": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string"
},
"current_user_role": "owner",
"default_coordinate_system": "string",
"description": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"labels": [
"string"
],
"ml_enabled": false,
"name": "string",
"self_link": "string",
"updated_at": "2024-07-29T15:51:28.071Z",
"updated_by": {
"email": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string"
}
}
]
}
401
No permission -- see authorization schemes
Response schema
detailstring | null
invalid-paramsarray | null
statusinteger
titlestring
typestring
Example response
{
"detail": "string",
"invalid-params": [
{
"name": "string",
"reason": "string"
}
],
"status": 0,
"title": "string",
"type": "string"
}
403
Request forbidden -- authorization will not help
Response schema
detailstring | null
invalid-paramsarray | null
statusinteger
titlestring
typestring
Example response
{
"detail": "string",
"invalid-params": [
{
"name": "string",
"reason": "string"
}
],
"status": 0,
"title": "string",
"type": "string"
}
404
Resource not found or user lacks access
Response schema
detailstring | null
invalid-paramsarray | null
statusinteger
titlestring
typestring
Example response
{
"detail": "string",
"invalid-params": [
{
"name": "string",
"reason": "string"
}
],
"status": 0,
"title": "string",
"type": "string"
}
405
Specified method is invalid for this resource
Response schema
detailstring | null
invalid-paramsarray | null
statusinteger
titlestring
typestring
Example response
{
"detail": "string",
"invalid-params": [
{
"name": "string",
"reason": "string"
}
],
"status": 0,
"title": "string",
"type": "string"
}
422
Unprocessable Content
Response schema
detailstring | null
invalid-paramsarray | null
statusinteger
titlestring
typestring
Example response
{
"detail": "string",
"invalid-params": [
{
"name": "string",
"reason": "string"
}
],
"status": 0,
"title": "string",
"type": "string"
}