Workspace Setup
Create workspaces, manage API tokens, and configure your fluidsoul environment.
Workspace Setup
A workspace is the top-level container in fluidsoul. Each workspace has its own events, user contexts, rules config, and API token.
Creating a workspace
Currently, workspaces are created during initial setup. A dashboard for self-serve workspace creation is coming soon (Stage 3).
API token
Your API token authenticates all requests. Include it in every API call:
Authorization: Bearer <your-token>
X-Workspace-Id: <your-workspace-uuid>Store tokens in environment variables — never hardcode them:
export FLUIDSOUL_API_TOKEN=fs_tok_xxxxxxxxxxxx
export FLUIDSOUL_WORKSPACE_ID=aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeeeRules config
Each workspace has a rules config that controls how users are classified. See Configuring Rules for the full schema.
Read and update via the API:
# Read current config
curl https://api.fluidsoul.dev/v1/workspace/config \
-H "Authorization: Bearer $TOKEN" \
-H "X-Workspace-Id: $WORKSPACE_ID"
# Update config
curl -X PUT https://api.fluidsoul.dev/v1/workspace/config \
-H "Authorization: Bearer $TOKEN" \
-H "X-Workspace-Id: $WORKSPACE_ID" \
-H "Content-Type: application/json" \
-d @rules-config.jsonEnvironment variables
| Variable | Required | Description |
|---|---|---|
FLUIDSOUL_API_URL | Yes | API server URL |
FLUIDSOUL_API_TOKEN | Yes | Bearer token |
FLUIDSOUL_WORKSPACE_ID | Yes | Workspace UUID |
FLUIDSOUL_LLM_PROVIDER | No | "anthropic" or "openai" (server-side only) |
FLUIDSOUL_LLM_API_KEY | No | LLM provider API key (server-side only) |
FLUIDSOUL_LLM_MODEL | No | Model name (server-side only) |