API reference
Workspaces
Manage workspace metadata, members, and the workspace context document — the brand-voice spec every skill reads first.
#The Workspace object
| Field | Type | Description |
|---|---|---|
| id | string | ws_xxx |
| name | string | |
| tier | "free"|"basic"|"pro"|"max"|"enterprise" | |
| createdAt | ISO 8601 | |
| memberCount | number |
#Get the current workspace
GET/v1/workspace
The "current" workspace is determined by the API key. Use workspaceId in your client config to override.
#Get merged context
GET/v1/workspace/context?merged=true
Returns the team layer with your personal override applied — what skills see at runtime.
#Get team context
GET/v1/workspace/context/team
#Update team context
PUT/v1/workspace/context/team
Requires admin scope. Replaces the document; pass full JSON.
| Field | Type | Description |
|---|---|---|
| product | string | |
| audience | string | |
| voice | string | |
| wordsToAvoid | string | |
| wordsToPrefer | string | |
| brandColors | string | |
| positioning | string | |
| noGoTopics | string |
curl -X PUT https://api.promptfloe.com/v1/workspace/context/team \
-H "Authorization: Bearer $PROMPTFLOE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"voice":"confident, plainspoken","wordsToAvoid":"synergy"}'#Update personal override
PUT/v1/workspace/context/override
User-scoped. Same field set as team. Empty fields fall through to the team layer at merge time.
#Members
GET/v1/workspace/members
POST/v1/workspace/members/invite
DELETE/v1/workspace/members/:userId
Member management requires admin scope.
#Where to go next
PromptFloe developer docs