# Workspaces

A **Workspace** is an operational domain inside your organization. It groups people, repositories, and connected resources for a specific team, product, or environment.

## How workspaces relate to the gateway

The Cloud and AI Gateway is an abstraction layer, and in practice your organization is usually structured into **multiple workspaces**. Each workspace can contain repositories, and those repositories attach cloud storage and AI/LLM resources.

## What you can do in Workspace management

* list all workspaces you can access,
* create a new workspace,
* edit workspace metadata/configuration,
* remove a workspace,
* manage workspace-level rights (read/write/admin, depending on role).

## Recommended structure patterns

* Split by environment: `dev`, `staging`, `prod`
* Split by business domain: `search`, `assistant`, `analytics`
* Split by security boundary: regulated vs non-regulated workloads

## Why this matters

Good workspace design improves:

* security isolation,
* policy clarity,
* cost attribution,
* and observability granularity.

## API mapping

* `POST /workspace`
* `GET /workspace`
* `GET /workspace/{id}`
* `PUT /workspace/{id}`
* `DELETE /workspace/{id}`

See: [Workspace API](https://docs.flashback.tech/support-reference/platform-api-reference/workspace)