Endpoint
GET
/v1/stable/workspace

Returns every workspace in the account. A workspace is the container that groups projects and the people who work on them. The call takes no paging parameters, so one request yields the whole set.

Request
Response

Authentication

Authorization
string
header
required

Voiceflow bearer token

Response

200 - application/json

Returns every workspace the authenticated account belongs to, each with its ID, name, image URL, and the organization it sits under.

workspaces
object[]
required
StableWorkspace — see its attributes above
Endpoint
POST
/v1/stable/workspace

Adds a workspace to the account, the container that groups projects and the people who work on them. The response carries the ID that later calls address it by.

Request
Response

Authentication

Authorization
string
header
required

Voiceflow bearer token

Request body

name
string
required
organizationID
string
required

The ID of the organization the workspace belongs to.

Response

201 - application/json

Creates the workspace and returns it, including the generated ID that later calls pass as workspaceID.

workspace
object
required
StableWorkspace — see its attributes above
Endpoint
GET
/v1/stable/workspace/{workspaceID}

Returns a single workspace by ID, with the fields that define it. A workspace is the container that groups projects and the people who work on them.

Request
Response

Authentication

Authorization
string
header
required

Voiceflow bearer token

Path parameters

workspaceID
string
required

The ID of the workspace to operate on.

Response

200 - application/json

Returns the one workspace, with its name, image URL, the organization it belongs to, and its creation and update timestamps.

workspace
object
required
StableWorkspace — see its attributes above
Endpoint
PATCH
/v1/stable/workspace/{workspaceID}

Changes an existing workspace in place. The response carries only a confirmation message, so refetch the workspace to read its new values.

Request
Response

Authentication

Authorization
string
header
required

Voiceflow bearer token

Path parameters

workspaceID
string
required

The ID of the workspace to operate on.

Request body

name
string

Response

200 - application/json

Confirms the workspace was updated. The body is a message, not the updated workspace, so refetch it to read the new values.

message
string
required

A human-readable message confirming the update.

Endpoint
DELETE
/v1/stable/workspace/{workspaceID}

Deletes a single workspace by ID. A workspace is the container that groups projects and the people who work on them. The response carries only a confirmation message, so refetch the workspaces to see what is left.

Request
Response

Authentication

Authorization
string
header
required

Voiceflow bearer token

Path parameters

workspaceID
string
required

The ID of the workspace to operate on.

Response

200 - application/json

Confirms the workspace was deleted. Only a message comes back, so list workspaces again to see what remains.

message
string
required

A human-readable message confirming the deletion.

Schemas

Use the up and down arrow keys to select a result, Enter to open it, and Escape to close the search.