Skip to main content
DELETE
/
open
/
workspaces
/
{workspaceId}
/
users
/
{userId}
/
remove
Remove Workspace User
curl --request DELETE \
  --url https://api.opnform.com/open/workspaces/{workspaceId}/users/{userId}/remove \
  --header 'Authorization: Bearer <token>'
{
  "message": "User removed from workspace successfully."
}

​
Remove Workspace User

Kick a member out of a workspace. If the removed user has no remaining workspaces, a personal workspace will be automatically created.

​
Authentication & Scope

Requires the workspace-users-write ability and admin privileges in the workspace.

​
Request

DELETE /open/workspaces/{workspaceId}/users/{userId}/remove HTTP/1.1
Host: api.opnform.com
Authorization: Bearer <token>

​
Path Parameters

ParameterTypeDescription
workspaceIdnumberID of the workspace.
userIdnumberID of the user to remove.

​
Response

200 OK – Confirmation message. 
{
  "message": "User removed from workspace successfully."
}
403 Forbidden – Token lacks workspace-users-write or insufficient privileges.

Authorizations

​
Authorization
string
header
required

Personal Access Token

Path Parameters

​
workspaceId
string
required
​
userId
string
required

Response

User removed

​
message
string
Example:

"User removed from workspace successfully."