---
title: "offboard a workspace user (reassign objects, optionally delete user)"
method: POST
path: "/w/{workspace}/users/offboard/{username}"
tags: ["user", "admin"]
---

# offboard a workspace user (reassign objects, optionally delete user)

`POST /w/{workspace}/users/offboard/{username}`

## Path parameters

- `workspace` string, required
- `username` string, required

## Request body

- OffboardRequest
  - `reassign_to` string, required — Target for reassignment: 'u/{username}' or 'f/{folder}'
  - `new_on_behalf_of_user` string — Required when reassign_to is a folder. The username whose identity will be used as permissioned_as for schedules and triggers.
  - `delete_user` boolean — Whether to also remove the user from the workspace

## Response `200`

offboard response with conflicts or summary

- OffboardResponse
  - `conflicts` string[] — List of path conflicts that block the offboarding. Empty on success.
  - `summary` OffboardSummary
    - `scripts_reassigned` integer, required
    - `flows_reassigned` integer, required
    - `apps_reassigned` integer, required
    - `resources_reassigned` integer, required
    - `variables_reassigned` integer, required
    - `schedules_reassigned` integer, required
    - `triggers_reassigned` integer, required
    - `drafts_deleted` integer, required

---

[API](https://skmtc.net/windmill/apis/windmill-api.md) · [All operations](https://skmtc.net/windmill/apis/windmill-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/windmill/windmill-api/versions/155a35b3caff/schema)