Runrunit

Interact with the Runrunit API

Descendants → Get Many

AI-generated

Summary

Retrieves a paginated list of descendant (child) tasks for a given parent task in Runrunit, with optional sorting. Can alternatively output a preview curl command instead of calling the API.

Inputs

  • Mode — 'Execute request' (default) performs the API call; 'Preview curl' only shows the curl command for the request.
  • Task ID (required) — ID of the parent task whose descendants are listed.
  • Limit — Max number of results to return, 1–100 (default 50). Sent as the 'limit' query parameter.
  • Page — 1-based page number for pagination (default 1). Sent as the 'page' query parameter.
  • Sort — Field name to sort results by. Sent as 'sort' query parameter; empty means no sorting.
  • Sort Direction — Ascending (default) or Descending. Only shown when Sort is set; sent as 'sort_dir'.

Output shape

A list of descendant task records for the given parent task, as returned by the Runrunit API (or a curl command preview when in Preview mode).

The source pack shows only signatures for the executor, so the exact output shape and the preview format are not confirmed. Results are paginated, so fetch further pages by incrementing Page. Limit is capped at 100 per request.

Examples

Example 1: List the first 50 subtasks of a task

Resource: Descendants, Operation: Get Many, Task ID set to the parent task ID, defaults for Limit and Page.

Example 2: Fetch the second page of 20 subtasks, newest first

Task ID set, Limit 20, Page 2, Sort 'created_at', Sort Direction Descending (the sort field name is an assumption; check the Runrunit API).

Example 3: Check the request before running it

Mode: Preview curl, Task ID set, to inspect the generated curl command without calling the API.

Links

Discussion