---
title: "Manage workspace users"
method: POST
path: "/manage_workspace_users"
tags: ["Organization"]
---

# Manage workspace users

`POST /manage_workspace_users`

This endpoint allows organization administrators to add or remove users from a workspace.

## Request body

- object
  - `organization_id` string, required — The ID of the organization that the workspace belongs to.
  - `user_id` string, required — Your user id -- you must be an organization admin to manage workspace users.
  - `workspace_id` string, required — The ID of the workspace to manage users for.
  - `action` 'add' | 'remove', required — The action to perform - either 'add' or 'remove' a user.
  - `user_email` string, required — The email address of the target user to add or remove.
  - `is_admin` boolean — When adding a user, specify whether they should have admin privileges (default is false).

## Response `200`

User successfully added to or removed from workspace

- object
  - `success` boolean
  - `message` string — A success message describing the action performed.

## Other responses

- `400` — Bad request (missing required parameters or invalid action)
- `401` — Unauthorized (missing or invalid API key)
- `403` — Forbidden (user is not an organization admin or workspace doesn't belong to organization)
- `404` — Organization, workspace, or user not found
- `500` — Internal server error

---

[API](https://skmtc.dev/gumloop/apis/public-api.md) · [All operations](https://skmtc.dev/gumloop/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gumloop/public-api/revisions/115f2d6ce387/schema)