Workspaces
The Workspace service manages workspaces, team members, invitations, subscriptions, and billing.
Concepts
Workspaces
A workspace is the top-level organizational unit. All resources (brand voices, audiences, generated content) belong to a workspace.
Members & Roles
Each workspace member has one of three roles:
| Role | Description |
|---|---|
OWNER | Full control, can manage billing and delete workspace |
ADMIN | Can manage members and most settings |
MEMBER | Can use features within the workspace |
Invitations
Members are added via email invitations with confirmation codes. Invitations can be accepted, denied, cancelled, or resent.
Endpoints
Base path: https://app.neuroflash.com/api/workspace-service
Workspaces
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/workspaces | Create a workspace |
GET | /v1/workspaces | List your workspaces |
GET | /v1/workspaces/{id} | Get a workspace |
PUT | /v1/workspaces/{id} | Update a workspace |
DELETE | /v1/workspaces/{id} | Delete a workspace |
Members
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/workspaces/{id}/workspace-members | List members |
GET | /v1/workspaces/{id}/workspace-members/{memberId} | Get a member |
PUT | /v1/workspaces/{id}/workspace-members/{memberId} | Update member role |
DELETE | /v1/workspaces/{id}/workspace-members/{memberId} | Remove a member |
Invitations
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/workspaces/{id}/invites | Create an invitation |
GET | /v1/workspaces/{id}/invites | List invitations |
DELETE | /v1/workspaces/{id}/invites/{inviteId} | Cancel an invitation |
Subscriptions & Billing
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/workspaces/{id}/current-subscription | Get current subscription |
GET | /v1/workspaces/{id}/billing-contact | Get billing contact |
PUT | /v1/workspaces/{id}/billing-contact | Update billing contact |
POST | /v1/workspaces/{id}/stripe-sessions | Get Stripe billing portal URL |