Voiceflow bearer token
Workspaces
Organize your projects and team access.
See Authentication for credentials and permissions.
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.
Authentication
Response
Returns every workspace the authenticated account belongs to, each with its ID, name, image URL, and the organization it sits under.
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.
Authentication
Voiceflow bearer token
Request body
The ID of the organization the workspace belongs to.
Response
Creates the workspace and returns it, including the generated ID that later calls pass as 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.
Authentication
Voiceflow bearer token
Path parameters
The ID of the workspace to operate on.
Response
Returns the one workspace, with its name, image URL, the organization it belongs to, and its creation and update timestamps.
Changes an existing workspace in place. The response carries only a confirmation message, so refetch the workspace to read its new values.
Authentication
Voiceflow bearer token
Path parameters
The ID of the workspace to operate on.
Request body
Response
Confirms the workspace was updated. The body is a message, not the updated workspace, so refetch it to read the new values.
A human-readable message confirming the update.
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.
Authentication
Voiceflow bearer token
Path parameters
The ID of the workspace to operate on.
Response
Confirms the workspace was deleted. Only a message comes back, so list workspaces again to see what remains.
A human-readable message confirming the deletion.