Workspaces

Manage workspaces and team members.

GET/api/workspacesJWT

List Workspaces

List all workspaces the authenticated user belongs to.

Response

json

{
  "data": [
    {
      "id": "uuid",
      "name": "My Workspace",
      "slug": "my-workspace",
      "plan": "starter",
      "credits_remaining": 850,
      "owner_id": "uuid"
    }
  ]
}

POST/api/workspacesJWT

Create Workspace

Create a new workspace. Maximum 3 workspaces per user.

Request Body

Name	Type	Required	Description
name	string	Required	Workspace name (min 2 chars)

Response

json

{
  "data": {
    "id": "uuid",
    "name": "New Workspace",
    "plan": "free"
  },
  "message": "Workspace created successfully"
}

POST/api/workspaces/:id/inviteJWT

Invite Member

Invite a user to the workspace by email. Requires owner or admin role.

URL Parameters

Name	Type	Required	Description
id	string	Required	Workspace ID

Request Body

Name	Type	Required	Description
email	string	Required	User's email
role	string	Optional	Role: admin or agent (default: agent)

Response

json

{
  "data": {
    "id": "uuid",
    "user_id": "uuid",
    "workspace_id": "uuid",
    "role": "agent"
  },
  "message": "Member invited successfully"
}