Get a workflow
Returns a single workflow together with a chosen slice of its related data: its details, its versions, one version in full, its run history, or one run in full.
Example: Read one workflow’s details, its version history, or the detail of a single run.
Usage: Pass the workflow id and set view to the slice you want: detail for the workflow itself, versions for its version history, version_detail for one version (needs the version id, and you can leave out the builder chat history), runs for its run history, or run_detail for one run (needs the run id). For runs you can filter by status, by where the run came from (a standalone workflow run, a grid cell, or a task), by a name search, or by when they were created, and the version and run lists come back in pages of up to 100 (50 by default).
Response: the workflow and whichever slice you asked for: its details, a list of versions, one version’s step config and chat, a list of runs, or one run’s status and progress.
Headers
Body
Run source (view='runs'): 'playbook' for standalone runs (default - this filter applies even when left unset, so it only returns playbook-sourced runs), 'grid' for grid-cell runs, 'task' for task-triggered runs. run_search does not search across all sources by itself - check each run_source explicitly when the source is unknown.
grid, playbook, task Response
Successful Response