Beautiful Open-Source Form Builder
---
openapi: get /open/workspaces/{workspaceId}/users
---
# List Workspace Users
Fetch all members of a workspace, including their assigned role.
## Authentication & Scope
Requires `workspace-users-read` ability. The requesting user must belong to the workspace.
## Request
```http
GET /open/workspaces/{workspaceId}/users HTTP/1.1
Host: api.opnform.com
Authorization: Bearer <token>
```
### Path Parameters
| Parameter | Type | Description |
|-------------|--------|----------------------------------|
| workspaceId | number | ID of the workspace to retrieve. |
No query parameters are supported.
## Response
`200 OK` – An array of user objects, each including a `role` field (from the pivot table).
```json
[
{
"id": 3,
"name": "Alice Porter",
"email": "[email protected]",
"role": "admin"
},
{
"id": 8,
"name": "Bob Smith",
"email": "[email protected]",
"role": "member"
}
]
```
`403 Forbidden` – Token lacks `workspace-users-read` or you are not a member.