---
title: "hiringTeam.removeMember"
method: POST
path: "/hiringTeam.removeMember"
tags: ["Hiring Team"]
---

# hiringTeam.removeMember

`POST /hiringTeam.removeMember`

Removes an Ashby user from the hiring team at the application, job, or opening level.

**Requires the [`organizationWrite`](authentication#permissions-hiringteamremovemember) permission.**

## Request body

- union
  - object
    - `applicationId` string, uuid, nullable, required — The application to unassign the user role from
    - `jobId` string, uuid, nullable — The job to unassign the user role from
    - `openingId` string, uuid, nullable — The opening to unassign the user role from
    - `teamMemberId` string, uuid, required — The id of the user to unassign the role from
    - `roleId` string, uuid, required — The id of the hiring team role to unassign from
  - object
    - `applicationId` string, uuid, nullable — The application to unassign the user role from
    - `jobId` string, uuid, nullable, required — The job to unassign the user role from
    - `openingId` string, uuid, nullable — The opening to unassign the user role from
    - `teamMemberId` string, uuid, required — The id of the user to unassign the role from
    - `roleId` string, uuid, required — The id of the hiring team role to unassign from
  - object
    - `applicationId` string, uuid, nullable — The application to unassign the user role from
    - `jobId` string, uuid, nullable — The job to unassign the user role from
    - `openingId` string, uuid, nullable, required — The opening to unassign the user role from
    - `teamMemberId` string, uuid, required — The id of the user to unassign the role from
    - `roleId` string, uuid, required — The id of the hiring team role to unassign from

## Response `200`

Responses from the hiringTeam.removeMember endpoint

- union
  - HiringTeamRemoveMemberSuccessResponse
    - `success` true, required
    - `results` HiringTeamRole[], required — The remaining hiring team roles after the member is removed
      - `userId` string, uuid, required — The unique identifier of the hiring team member
      - `firstName` string, required — The first name of the hiring team member
      - `lastName` string, required — The last name of the hiring team member
      - `email` string, email, required — The primary email address of the hiring team member
      - `role` string, required — The hiring team role assigned to the member
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

[API](https://skmtc.net/ashbyhq/apis/ashby-api.md) · [All operations](https://skmtc.net/ashbyhq/apis/ashby-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ashbyhq/ashby-api/revisions/778b919dc743/schema)