--- title: "Get a Run" method: GET path: "/projects/{owner}/{name}/runs/{run_id}" tags: ["Runs"] --- # Get a Run `GET /projects/{owner}/{name}/runs/{run_id}` Retrieve a run. ## Path parameters - `owner` string, required - `name` string, required - `run_id` string, required ## Response `200` Retrieved - Run - `id` string, required — The unique ID for this run - `author` AccountPublic - `id` string, required - `account_type` string, required - `name` string, required - `display_name` string - `description` string - `picture_url` string — https://robohash.org/ladybugbot - `owner` AccountPublic - `id` string, required - `account_type` string, required - `name` string, required - `display_name` string - `description` string - `picture_url` string — https://robohash.org/ladybugbot - `recipe` RecipeInterface — An interface object for creating a Recipe. Recipe information only includes metadata, source, inputs and outputs of a Recipe. This object is useful for creating user interface for Recipes. - `type` string - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries. - `api_version` string - `metadata` MetaData, required — Package metadata information. - `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 — Package name. Make it descriptive and helpful ;) - `tag` string, required — The tag of the package - `app_version` string — The version of the application code underlying the manifest - `keywords` string[] — A list of keywords to search the package by - `maintainers` Maintainer[] — A list of maintainers for the package - `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 — The name of the author/maintainer person or organization. - `email` string — The email address of the author/maintainer person or organization. - `home` string — The URL of this package's home page - `sources` string[] — A list of URLs to source code for this project - `icon` string — A URL to an SVG or PNG image to be used as an icon - `deprecated` boolean — Whether this package is deprecated - `description` string — A description of what this package does - `license` License — License information for the Package - `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 — The license name used for the package. - `url` string, uri — A URL to the license used for the package. - `source` string — A URL to the source this recipe from a registry. - `inputs` union[] — A list of recipe inputs. - union - DAGGenericInput — Base class for DAG inputs. This class adds a handler to input to handle the process of loading the input from different graphical interfaces. - `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 for generic input. - `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. - DAGStringInput — A String input. You can add additional validation by defining a JSONSchema specification. See http://json-schema.org/understanding-json-schema/reference/string.html#string for more information. .. code-block:: python "schema": { "type": "string", "maxLength": 50, "pattern": "(?i)(^.*\.epw$)" } - `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. - DAGIntegerInput — An integer input. You can add additional validation by defining a JSONSchema specification. See http://json-schema.org/understanding-json-schema/reference/numeric.html#numeric for more information. - `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. - DAGNumberInput — A number input. You can add additional validation by defining a JSONSchema specification. See http://json-schema.org/understanding-json-schema/reference/numeric.html#numeric for more information. - `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. - DAGBooleanInput — The boolean type matches only two special values: True and False. Note that values that evaluate to true or false, such as 1 and 0, are not accepted. You can add additional validation by defining a JSONSchema specification. See http://json-schema.org/understanding-json-schema/reference/boolean.html for more information. - `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. - DAGFolderInput — A folder input. Folder is a special string input. Unlike other string inputs, a folder will be copied from its location to execution folder when a workflow is executed. You can add additional validation by defining a JSONSchema specification. See http://json-schema.org/understanding-json-schema/reference/string.html#string for more information. .. code-block:: python "schema": { "type": "string", "maxLength": 50, } - `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. - DAGFileInput — A file input. File is a special string input. Unlike other string inputs, a file will be copied from its location to execution folder when a workflow is executed. You can add additional validation by defining a JSONSchema specification. See http://json-schema.org/understanding-json-schema/reference/string.html#string for more information. .. code-block:: python # a file with maximum 50 characters with an ``epw`` extension. "schema": { "type": "string", "maxLength": 50, "pattern": "(?i)(^.*\.epw$)" } - `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. - `extensions` string[] — Optional list of extensions for file. The check for extension is case-insensitive. - DAGPathInput — A file or a folder input. Use this input only in cases that the input can be either a file or folder. For file or folder-only inputs see File and Folder. Path is a special string input. Unlike other string inputs, a path will be copied from its location to execution folder when a workflow is executed. You can add additional validation by defining a JSONSchema specification. See http://json-schema.org/understanding-json-schema/reference/string.html#string for more information. .. code-block:: python # a file with maximum 50 characters with an ``epw`` extension. "schema": { "type": "string", "maxLength": 50, "pattern": "(?i)(^.*\.epw$)" } - `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. - `extensions` string[] — Optional list of extensions for path. The check for extension is case-insensitive. The extension will only be validated for file inputs. - DAGArrayInput — A JSON array input. You can add additional validation by defining a JSONSchema specification. See http://json-schema.org/understanding-json-schema/reference/array.html for more information. - `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. - DAGJSONObjectInput — A JSON object input. JSON objects are similar to Python dictionaries. You can add additional validation by defining a JSONSchema specification. See http://json-schema.org/understanding-json-schema/reference/object.html for more information. - `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. - `outputs` union[] — A list of recipe outputs. - union - DAGGenericOutput — DAG generic output. In most cases, you should not be using the generic output unless you need a dynamic output that changes its type in different platforms because of returning different objects in handler. - `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. - `from` unknown, required - `alias` union[] — A list of additional processes for loading this output on different platforms. - union - … - DAGStringOutput — DAG string output. This output loads the content from a file as a string. - `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. - `from` union, required — Reference to a file or a task output. Task output must be file. - TaskReference — A Task reference for parameters other than files or folders. - … - FileReference — Reference to a file. - … - `alias` union[] — A list of additional processes for loading this output on different platforms. - union - … - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - DAGIntegerOutput — DAG integer output. This output loads the content from a file as an integer. - `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. - `from` union, required — Reference to a file or a task output. Task output must be file. - TaskReference — A Task reference for parameters other than files or folders. - … - FileReference — Reference to a file. - … - `alias` union[] — A list of additional processes for loading this output on different platforms. - union - … - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - DAGNumberOutput — DAG number output. This output loads the content from a file as a floating number. - `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. - `from` union, required — Reference to a file or a task output. Task output must be file. - TaskReference — A Task reference for parameters other than files or folders. - … - FileReference — Reference to a file. - … - `alias` union[] — A list of additional processes for loading this output on different platforms. - union - … - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - DAGBooleanOutput — DAG boolean output. This output loads the content from a file as a boolean. - `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. - `from` union, required — Reference to a file or a task output. Task output must be file. - TaskReference — A Task reference for parameters other than files or folders. - … - FileReference — Reference to a file. - … - `alias` union[] — A list of additional processes for loading this output on different platforms. - union - … - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - DAGFolderOutput — DAG 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. - `from` union, required — Reference to a folder or a task output. Task output must be folder. - TaskReference — A Task reference for parameters other than files or folders. - … - FolderReference — Reference to a folder. - … - `alias` union[] — A list of additional processes for loading this output on different platforms. - union - … - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - DAGFileOutput — DAG 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. - `from` union, required — Reference to a file or a task output. Task output must be file. - TaskReference — A Task reference for parameters other than files or folders. - … - FileReference — Reference to a file. - … - `alias` union[] — A list of additional processes for loading this output on different platforms. - union - … - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - DAGPathOutput — DAG path 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. - `from` union, required — Reference to a file, folder or a task output. Task output must either be a file or a folder. - TaskReference — A Task reference for parameters other than files or folders. - … - FileReference — Reference to a file. - … - FolderReference — Reference to a folder. - … - `alias` union[] — A list of additional processes for loading this output on different platforms. - union - … - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - DAGArrayOutput — DAG array output. This output loads the content from a JSON file which must be a JSON Array. - `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. - `from` union, required — Reference to a file or a task output. Task output must be file. - TaskReference — A Task reference for parameters other than files or folders. - … - FileReference — Reference to a file. - … - `alias` union[] — A list of additional processes for loading this output on different platforms. - union - … - `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. - DAGJSONObjectOutput — DAG object output. This output loads the content from a file as a JSON object. - `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. - `from` union, required — Reference to a file or a task output. Task output must be file. - TaskReference — A Task reference for parameters other than files or folders. - … - FileReference — Reference to a file. - … - `alias` union[] — A list of additional processes for loading this output on different platforms. - union - … - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional. - `generation` number — The generation of this run - `status` RunStatus — Job Status. - `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 for this run. - 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 run. - 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. - `api_version` string - `id` string, required — The ID of the individual run. - `job_id` string, required — The ID of the job that generated this run. - `entrypoint` string — The ID of the first step in the run. - `status` 'Created' | 'Scheduled' | 'Running' | 'Post-Processing' | 'Failed' | 'Cancelled' | 'Succeeded' | 'Unknown' — Enumaration of allowable status strings - `steps` object - `meta` RunMeta - `resources_duration` ResourcesDuration - `cpu` integer - `memory` integer - `progress` RunProgress - `completed` integer - `running` integer - `total` integer ## 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)