--- title: "Query the steps of a run" method: GET path: "/projects/{owner}/{name}/runs/{run_id}/steps" tags: ["Runs"] deprecated: true --- # Query the steps of a run `GET /projects/{owner}/{name}/runs/{run_id}/steps` > **Deprecated.** list run steps ## Path parameters - `owner` string, required - `name` string, required - `run_id` string, required ## Query parameters - `status` 'Scheduled' | 'Running' | 'Failed' | 'Succeeded' | 'Skipped' | 'Unknown' — Enumaration of allowable status strings - `step_id` string[] - `until_generation` string - `since_generation` string - `page` integer — Page number starting from 1 - `per-page` integer — Number of items per page ## Response `200` Retrieved - StepList — A list response from a pagination request - `page` integer, required — The current page the pagination request is on - `per_page` integer, required — The number of pages per pagination request - `next_page` integer — The next page, if this on is not the last - `page_count` integer, required — The total number of pages - `total_count` integer, required — The total number of resources matching the list request - `resources` StepStatus[], required - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `inputs` union[], required — The inputs used by this step. - union - StepStringInput — A String input. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Input name. - `description` string — Optional description for input. - `default` string — Default value to use for an input if a value was not supplied. - `alias` union[] — A list of aliases for this input in different platforms. - union - … - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided. - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec. - `value` string, required - StepIntegerInput — An integer input. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Input name. - `description` string — Optional description for input. - `default` integer — Default value to use for an input if a value was not supplied. - `alias` union[] — A list of aliases for this input in different platforms. - union - … - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided. - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec. - `value` integer, required - StepNumberInput — A number input. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Input name. - `description` string — Optional description for input. - `default` number — Default value to use for an input if a value was not supplied. - `alias` union[] — A list of aliases for this input in different platforms. - union - … - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided. - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec. - `value` number, required - StepBooleanInput — The boolean type matches only two special values: True and False. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Input name. - `description` string — Optional description for input. - `default` boolean — Default value to use for an input if a value was not supplied. - `alias` union[] — A list of aliases for this input in different platforms. - union - … - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided. - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec. - `value` boolean, required - StepFolderInput — A folder input. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Input name. - `description` string — Optional description for input. - `default` union — The default source for file if the value is not provided. - HTTP — HTTP Source A web HTTP to an FTP server or an API for example. - … - S3 — S3 Source An S3 bucket artifact Source. - … - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder. - … - `alias` union[] — A list of aliases for this input in different platforms. - union - … - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided. - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec. - `path` string — Path to the target location that the input will be copied to. This path is relative to the working directory where the command is executed. - `source` union, required — The path to source the file from. - HTTP — HTTP Source A web HTTP to an FTP server or an API for example. - … - S3 — S3 Source An S3 bucket artifact Source. - … - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder. - … - StepFileInput — A file input. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Input name. - `description` string — Optional description for input. - `default` union — The default source for file if the value is not provided. - HTTP — HTTP Source A web HTTP to an FTP server or an API for example. - … - S3 — S3 Source An S3 bucket artifact Source. - … - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder. - … - `alias` union[] — A list of aliases for this input in different platforms. - union - … - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided. - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec. - `path` string — Path to the target location that the input will be copied to. This path is relative to the working directory where the command is executed. - `extensions` string[] — Optional list of extensions for file. The check for extension is case-insensitive. - `source` union, required — The path to source the file from. - HTTP — HTTP Source A web HTTP to an FTP server or an API for example. - … - S3 — S3 Source An S3 bucket artifact Source. - … - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder. - … - StepPathInput — A file or a folder input. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Input name. - `description` string — Optional description for input. - `default` union — The default source for file if the value is not provided. - HTTP — HTTP Source A web HTTP to an FTP server or an API for example. - … - S3 — S3 Source An S3 bucket artifact Source. - … - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder. - … - `alias` union[] — A list of aliases for this input in different platforms. - union - … - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided. - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec. - `path` string — Path to the target location that the input will be copied to. This path is relative to the working directory where the command is executed. - `extensions` string[] — Optional list of extensions for file. The check for extension is case-insensitive. - `source` union, required — The path to source the file from. - HTTP — HTTP Source A web HTTP to an FTP server or an API for example. - … - S3 — S3 Source An S3 bucket artifact Source. - … - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder. - … - StepArrayInput — A JSON array input. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Input name. - `description` string — Optional description for input. - `default` unknown[] — Default value to use for an input if a value was not supplied. - unknown - `alias` union[] — A list of aliases for this input in different platforms. - union - … - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided. - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec. - `items_type` 'Generic' | 'String' | 'Integer' | 'Number' | 'Boolean' | 'Array' | 'JSONObject' — Type enum for items in a list. Items can not be files or folder. For a list of files you should copy them to a folder and use FolderInput input instead of using ArrayInput. - `value` unknown[], required - unknown - StepJSONObjectInput — A JSON object input. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Input name. - `description` string — Optional description for input. - `default` object — Default value to use for an input if a value was not supplied. - `alias` union[] — A list of aliases for this input in different platforms. - union - … - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided. - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec. - `value` object, required - `outputs` union[], required — The outputs produced by this step. - union - StepStringOutput — A String output. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Output name. - `description` string — Optional description for output. - `path` string, required — Path to the output file relative to where the function command is executed. - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - `value` string, required - StepIntegerOutput — An integer output. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Output name. - `description` string — Optional description for output. - `path` string, required — Path to the output file relative to where the function command is executed. - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - `value` integer, required - StepNumberOutput — A number output. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Output name. - `description` string — Optional description for output. - `path` string, required — Path to the output file relative to where the function command is executed. - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - `value` number, required - StepBooleanOutput — The boolean type matches only two special values: True and False. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Output name. - `description` string — Optional description for output. - `path` string, required — Path to the output file relative to where the function command is executed. - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - `value` boolean, required - StepFolderOutput — A folder output. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Output name. - `description` string — Optional description for output. - `path` string, required — Path to the output folder relative to where the function command is executed. - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - `source` union, required — The path to source the file from. - HTTP — HTTP Source A web HTTP to an FTP server or an API for example. - … - S3 — S3 Source An S3 bucket artifact Source. - … - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder. - … - StepFileOutput — A file output. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Output name. - `description` string — Optional description for output. - `path` string, required — Path to the output file relative to where the function command is executed. - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - `source` union, required — The path to source the file from. - HTTP — HTTP Source A web HTTP to an FTP server or an API for example. - … - S3 — S3 Source An S3 bucket artifact Source. - … - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder. - … - StepPathOutput — A file or a folder output. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Output name. - `description` string — Optional description for output. - `path` string, required — Path to the output file or folder relative to where the function command is executed. - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - `source` union, required — The path to source the file from. - HTTP — HTTP Source A web HTTP to an FTP server or an API for example. - … - S3 — S3 Source An S3 bucket artifact Source. - … - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder. - … - StepArrayOutput — A JSON array output. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Output name. - `description` string — Optional description for output. - `path` string, required — Path to the output file relative to where the function command is executed. - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - `items_type` 'Generic' | 'String' | 'Integer' | 'Number' | 'Boolean' | 'Array' | 'JSONObject' — Type enum for items in a list. Items can not be files or folder. For a list of files you should copy them to a folder and use FolderInput input instead of using ArrayInput. - `value` unknown[], required - unknown - StepJSONObjectOutput — A JSON object output. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `name` string, required — Output name. - `description` string — Optional description for output. - `path` string, required — Path to the output file relative to where the function command is executed. - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - `value` object, required - `message` string — Any message produced by the task. Usually error/debugging hints. - `started_at` string, date-time, required — The time at which the task was started - `finished_at` string, date-time — The time at which the task was completed - `source` string — Source url for the status object. It can be a recipe or a function. - `id` string, required — The step unique ID - `name` string, required — A human readable name for the step. Usually defined by the DAG task name but can be extended if the step is part of a loop for example. This name is unique within the boundary of the DAG/Job that generated it. - `status` 'Scheduled' | 'Running' | 'Failed' | 'Succeeded' | 'Skipped' | 'Unknown' — Enumaration of allowable status strings - `status_type` 'Function' | 'DAG' | 'Loop' | 'Container' | 'Unknown', required — Type enum for status type. - `template_ref` string, required — The name of the template that spawned this step - `command` string — The command used to run this step. Only applies to Function steps. - `boundary_id` string — This indicates the step ID of the associated template root step in which this step belongs to. A DAG step will have the id of the parent DAG for example. - `children_ids` string[], required — A list of child step IDs - `outbound_steps` string[], required — A list of the last step to ran in the context of this step. In the case of a DAG or a job this will be the last step that has been executed. It will remain empty for functions. ## Other responses - `422` — Validation Error --- [API](https://skmtc.net/pollination/apis/pollination-server.md) · [All operations](https://skmtc.net/pollination/apis/pollination-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pollination/pollination-server/revisions/c1f3c6d96b31/schema)