---
title: "Delete organization user"
method: POST
path: "/organizations/users/{id}/actions/remove"
tags: ["Organization Users"]
---

# Delete organization user

`POST /organizations/users/{id}/actions/remove`

Deletes a user in your organization.

## Path parameters

- `id` string, required

## Response `200`

Successful response with details about an Organization User.

- object
  - `data` OrganizationUser
    - `id` string — Identifies the specific resource.
    - `record_type` string — Identifies the type of the resource. Can be 'organization_owner' or 'organization_sub_user'.
    - `email` string, email — The email address of the user.
    - `user_status` 'enabled' | 'disabled' | 'blocked' — The status of the account.
    - `organization_user_bypasses_sso` boolean — Indicates whether this user is allowed to bypass SSO and use password authentication.
    - `created_at` string — ISO 8601 formatted date indicating when the resource was created.
    - `last_sign_in_at` string, nullable — ISO 8601 formatted date indicating when the resource last signed into the portal. Null if the user has never signed in.
    - `groups` UserGroupReference[] — The groups the user belongs to. Only included when include_groups parameter is true.
      - `id` string, required — The unique identifier of the group.
      - `name` string, required — The name of the group.

## Other responses

- `400` — Bad request, the request was unacceptable, often due to missing a required parameter.
- `401` — Unauthorized
- `403` — The user doesn't have the required permissions to perform the requested action.
- `404` — The requested resource doesn't exist.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)