Runrunit

Interact with the Runrunit API

Descendants → Create

AI-generated

Summary

Creates a descendant (child task) under a given parent task in Runrunit, sending a JSON task payload. Can alternatively preview the equivalent curl command without calling the API.

Inputs

  • mode — "Execute request" (default) performs the API call; "Preview curl" only builds and shows the curl command instead of executing it.
  • taskId (required) — ID of the parent task under which the descendant is created.
  • descendantObject — JSON object for the descendant/task, sent as the task property of the request body. Defaults to {"title":""}; you will normally set at least a title and any other Runrunit task fields.

Output shape

In Execute mode, the Runrunit API response for the newly created descendant task; in Preview mode, a curl command describing the request.

The source pack shows only stubs for the executor and request helper, so the exact response shape and preview format are not verifiable. Invalid JSON in the payload will likely cause an error.

Examples

Example 1: Add a subtask to an existing task

Mode: Execute request; Task ID: 12345; Descendant Object: {"title":"Review draft"}

Example 2: Check the request before running it

Mode: Preview curl; Task ID from a previous node expression; Descendant Object with title and other task fields

Links

Discussion