---
title: "Update Staff"
method: PATCH
path: "/staffs/{id}"
tags: ["Task"]
---

# Update Staff

`PATCH /staffs/{id}`

Update an existing staff. All fields are optional; only the supplied fields are changed. Passing `property_ids` replaces the staff's full property assignment list (use an empty array to clear). Use `is_active` to enable or disable the staff.

## Path parameters

- `id` integer, required

## Request body

- object
  - `name` string
  - `mobile` string
  - `email` string
  - `note` string
  - `is_active` boolean — Enable (`true`) or disable (`false`) the staff.
  - `property_ids` integer[] — Replaces the staff's property assignment list. Use an empty array to remove all assignments.

## Response `200`

The staff has been successfully updated.

- CommonResponse
  - `request_id` string, required — Unique identifier for the request.
  - `error_code` integer, required — Numeric error code representing the status of the response. A value of `200` indicates success. <br> See the [Error Codes](/reference/error-manual#error-codes) section for more information.
  - `error_msg` string, required — Message detailing the status of the response.

---

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