List workspaces

List workspaces

curl --request GET \
  --url https://api.altostrat.io/workspaces \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "ws_a1b2c3d4e5f6g7h8",
      "name": "ACME Corporation",
      "description": "Primary workspace for all ACME projects.",
      "billing_mode": "pooled",
      "pooled_seat_limit": 100,
      "archived": false,
      "created_at": "2025-10-29T00:40:06.000000Z",
      "updated_at": "2025-10-29T00:40:06.000000Z",
      "archived_at": null
    }
  ],
  "has_more": false
}

GET

workspaces

List workspaces

curl --request GET \
  --url https://api.altostrat.io/workspaces \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "ws_a1b2c3d4e5f6g7h8",
      "name": "ACME Corporation",
      "description": "Primary workspace for all ACME projects.",
      "billing_mode": "pooled",
      "pooled_seat_limit": 100,
      "archived": false,
      "created_at": "2025-10-29T00:40:06.000000Z",
      "updated_at": "2025-10-29T00:40:06.000000Z",
      "archived_at": null
    }
  ],
  "has_more": false
}

Authorizations

Authorization

string

header

required

Enter your JWT in the format: Bearer {token}

Response

A list of workspaces.

data

object[]

Show child attributes

data.id

string

Unique identifier for the workspace, prefixed with ws_.

Example:

"ws_a1b2c3d4e5f6g7h8"

data.name

string

The name of the workspace.

Example:

"ACME Corporation"

data.description

string | null

An optional description for the workspace.

Example:

"Primary workspace for all ACME projects."

data.billing_mode

enum<string>

The billing mode for the workspace. Determines how subscriptions and usage are handled.

Available options:

single,

assigned,

pooled

Example:

"pooled"

data.pooled_seat_limit

integer | null

The total number of seats available in 'pooled' billing mode. This is null for other modes.

Example:

100

data.archived

boolean

Whether the workspace is archived.

Example:

false

data.created_at

string<date-time>

The timestamp when the workspace was created.

Example:

"2025-10-29T00:40:06.000000Z"

data.updated_at

string<date-time>

The timestamp when the workspace was last updated.

Example:

"2025-10-29T00:40:06.000000Z"

data.archived_at

string<date-time> | null

The timestamp when the workspace was archived.

Example:

null

has_more

boolean

Example:

false

API Introduction

Create a workspace

⌘I

Getting Started

Platform & Identity

Device Management & Orchestration

Automation & AI

Network Services & Connectivity

Security & Threat Management

Monitoring & Analytics

Core Services & Utilities

Authorizations

Response