Workspaces

Get All Workspaces

Changed on

Retrieve a cursor-paginated list of all workspaces.

get/v2/workspaces

Request

  • Base URL: https://{customer-domain}/maestro/api
  • URL: https://{customer-domain}/maestro/api/v2/workspaces
  • Auth: none declared

Query parameters

cursorstring

Cursor from the previous page response for fetching the next page

limitinteger

Maximum number of items to return per page (1-50, default 20)

Response

OK

Example response

{
  "content": [
    {
      "id": "Ws69a976d02587b929c9e26dfa",
      "createdBy": {
        "id": "1C341E7B682505430A494138@0bd0200063c87f9749412b.e",
        "name": "Jane Doe"
      },
      "createdAt": "2026-01-15T10:30:00.000Z",
      "updatedBy": {
        "id": "1C341E7B682505430A494138@0bd0200063c87f9749412b.e",
        "name": "Jane Doe"
      },
      "updatedAt": "2026-01-15T14:45:00.000Z",
      "alias": "marketing-workspace",
      "name": "Marketing Workspace",
      "description": "Workspace for managing marketing campaigns and assets",
      "color": "blue",
      "icon": "briefcase",
      "ownerId": "1C341E7B682505430A494138@0bd0200063c87f9749412b.e",
      "recordTypeSections": [
        {
          "displayName": "Marketing"
        }
      ]
    }
  ],
  "cursor": {
    "nextCursor": "UnQ2OWIxNGY3ZTBlMzhmMzVmMjhjM2NjZWU="
  }
}

Changes