Remove followers

Removes one or more users from the follower list of the specified entity. Once removed, these users will no longer
receive notifications about updates, comments, or status changes for the entity. This operation is useful for
managing notification lists and removing users who no longer need to track specific entities.

Key Features:

  • Supports bulk removal of multiple followers in a single request
  • Validates user IDs before processing removal
  • Gracefully handles cases where users are not currently followers
  • Automatically converts user GUIDs to internal format for processing

Authorization Logic:

  1. User must have a valid JWT token with appropriate scopes
  2. Token is valid for this operation
  3. User must have permission to manage the target entity
  4. Users can typically remove themselves as followers with view permissions

Usage Example:

Remove team members from following a completed program to reduce notification noise.

Success Response:

Returns 204 No Content when followers are successfully removed. No response body is included.

Path Params
string
required
length between 7 and 22

The unique identifier of the space containing the target entity. This determines the scope of entity queries and ensures proper access control. The space must be accessible to the authenticated user with appropriate permissions. It can be the unique identifier (GUID) of the space or the word "default" to indicate the default programs space. Common values include "default" and "rkr83lapKkyCJuLLWqLqzB".

string
required

Unique identifier of the program, task, or request to remove followers from. Example:

mKx8fqRTQ0OvZsGpYhNrLw

Body Params

Request body containing the array of user IDs to remove from the follower list of the specified entity. Each user ID should be a GUID-format identifier (e.g., '56d7d33f-1d42-461b-85eb-26b7b2872c88') referencing existing followers to unfollow. Users specified in this request will no longer receive notifications about the entity and will be removed from the follower list. Non-existent user IDs or users who are not currently following will be silently ignored. Supports removing multiple followers in a single request for efficient batch operations.

followerIds
array of strings

Array of unique user or user group identifiers to be removed from the follower list of the specified entity. Each ID must correspond to an existing follower. Use to bulk unfollow multiple users or groups in a single operation.

followerIds
Responses
204

No Content

Language
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json