Add followers

Adds one or more users as followers to the specified entity. Followers will receive notifications when the entity is updated,
commented on, or when its status changes. This operation requires appropriate permissions and validates all user
IDs before adding them.

Key Features:

  • Validates all provided user IDs exist in the system before processing
  • Supports bulk addition of multiple followers in a single request
  • Returns complete follower information including user details
  • Automatically converts user GUIDs to internal format for processing

Authorization Logic:

  1. User must have a valid JWT token with appropriate scopes
  2. User must have permission to manage the target entity
  3. All follower user IDs must exist and be valid in the tenant

Usage Example:

Add team members as followers to receive updates about a critical program milestone.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
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 add followers to. Example: mKx8fqRTQ0OvZsGpYhNrLw

Body Params

Request body containing the array of user IDs to add as followers to the specified entity. Each user ID should be a GUID-format identifier (e.g., '56d7d33f-1d42-461b-85eb-26b7b2872c88') referencing an existing user account in the system. The request must include at least one valid user ID. All specified users will receive follower notifications for the entity and appear in the follower list. Users must have appropriate permissions to be added as followers. Supports adding multiple followers in a single request for efficient bulk operations.

followerIds
array of strings

Array of unique user or user group identifiers to be added to the follower list of the specified entity. Each ID must reference a valid user or group with appropriate permissions. Use to bulk add multiple followers in a single operation.

followerIds
Responses

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