Workspaces
How workspaces organize your content, connections, and settings.
Workspaces are isolated containers for your content. Each workspace has its own generations, posts, media, social connections, writing styles, webhook configuration, and defaults.
Use workspaces to separate different brands, clients, or projects within a single PowerPost account.
What's Workspace-Scoped
Each workspace is fully independent — data in one workspace is never visible to another.
| Feature | Scoped to |
|---|---|
| Generations | Workspace |
| Posts & drafts | Workspace |
| Media (uploads & AI) | Workspace |
| Writing styles | Workspace |
| Social connections | Workspace |
| Webhook config | Workspace |
| Workspace defaults | Workspace |
What's Account-Level
Some features apply to your entire account, shared across all workspaces.
| Feature | Scoped to |
|---|---|
| Credit balance | Account |
| API keys | Account |
| Profile | Account |
Credits are deducted from a single account-wide balance regardless of which workspace triggers the generation.
Using Workspaces with the API
All content endpoints require the X-Workspace-Id header to specify which workspace the request targets.
curl https://powerpost.ai/api/v1/content/generate \
-H "x-api-key: pp_live_sk_YOUR_KEY_HERE" \
-H "X-Workspace-Id: YOUR_WORKSPACE_ID" \
-H "Content-Type: application/json" \
-d '{ "prompt": "Launch announcement", "post_types": ["tiktok-video"] }'Which endpoints need it
- All content endpoints —
/content/*,/images/*,/posts/*,/media/* - Not needed —
/account/credits(account-level)
Finding your workspace ID
- Go to Settings → Workspaces in the PowerPost dashboard
- Click the copy button next to any workspace to copy its ID
Errors
| Status | Meaning |
|---|---|
400 | X-Workspace-Id header is missing |
403 | You don't own the specified workspace |
Managing Workspaces
Create, rename, switch, and delete workspaces from Settings → Workspaces in the dashboard. All users can create unlimited workspaces.
Deleting a workspace permanently removes all its content, connections, and settings. This cannot be undone.