academyFIVE API icon

academyFIVE API

Interact with academyFIVE API

Actions549

Task-watchers [Beta] → Get paginated list of task watchers

AI-generated

Summary

Fetches a paginated list of task watchers from the academyFIVE API, optionally filtered by profile IDs or task IDs. The response may include related resources requested with the include parameter.

Inputs

  • page[number] — Page number to retrieve, starting at 1; the declared default is 1.
  • page[size] — Number of results per page; the declared default is 50.
  • filter[profileIds] — Comma-separated profile IDs to filter the watchers by.
  • filter[taskIds] — Comma-separated task IDs to filter the watchers by.
  • include — Comma-separated related resources to include in the response, such as profile.

Output shape

A list of JSON items returned by the API, typically representing task watchers.

Each returned item is paired with its corresponding input item. With Continue On Fail enabled, an item that encounters an error instead returns an { "error": "..." } JSON object. The UI describes pagination defaults, but these fields are optional and the source does not apply defaults itself.

Examples

Example 1: Get the second page of 25 watchers for tasks 1 and 2, including each watcher's profile.

Set page[number] to 2, page[size] to 25, filter[taskIds] to 1,2, and include to profile.

Links

Discussion