Skip to main content
Use this endpoint to bulk-update the status of one or more users in your Botsify workspace. The new status is supplied as a path parameter, and you provide the list of target user IDs in the request body. Optionally, you can scope the operation to a specific segment by including a segment_id. Authentication requires a valid Bearer token.

​
Path Parameters

​
string
required
The new status to apply to the specified users. This value is included directly in the URL path (e.g., /api/v1/user/change-status/active).

​
Request Body

​
array of integers
required
An array of integer user IDs identifying the users whose status you want to update. You must supply at least one ID.
​
integer
An optional segment ID. When provided, the status change is applied only to users who both appear in user_ids and belong to the specified segment.

​
Example Request

​
Response

A successful request returns a JSON object confirming the number of users whose status was updated, along with the applied status value. If any user IDs were not found or did not match the segment filter, the response may include a list of skipped IDs.