> For the complete CircleCI developer hub index, see [llms.txt](https://circleci.com/developer/llms.txt)

# circleci/continuation

Utilize Setup Workflows and the Continuation orb to easily construct dynamic and multi-config pipelines.


## Commands

### continue

Makes a post request to https://circleci.com/api/v2/pipeline/continue to continue a setup workflow.


| Parameter | Type | Default | Description |
|---|---|---|---|
| `circleci_domain` | string | circleci.com | The domain of the CircleCI installation - defaults to circleci.com. (Only necessary for CircleCI Server users) |
| `configuration_path` | string |  | The path to the configuration that will be passed to the continue API |
| `files_changed` | string | /tmp/files-changed-list | This is the file containing the changed files from the path-filtering orb. |
| `parameter_for_files_changed` | string |  | Name of the parameter that receives the list of changed files from the path filtering orb. Defaults to an empty string. Leave empty if you don't need this parameter.
 |
| `parameters` | string | {} | The parameters used for the pipeline. This can either be a JSON object containing parameters or a path to a file containing a JSON object with parameters |
| `when` | enum | on_success | Specify when to enable or disable this command |

### finish

Makes a post request to https://circleci.com/api/v2/pipeline/continue with an empty config to advance the pipeline, but not execute any further workflows, preventing other continuations.


| Parameter | Type | Default | Description |
|---|---|---|---|
| `circleci_domain` | string | circleci.com | The domain of the CircleCI installation - defaults to circleci.com. (Only necessary for CircleCI Server users) |

## Jobs

### continue

Make a request to the API to continue the pipeline.


| Parameter | Type | Default | Description |
|---|---|---|---|
| `checkout` | boolean | true | Whether to run an optional checkout step before continuing |
| `circleci_domain` | string | circleci.com | The domain of the CircleCI installation - defaults to circleci.com. (Only necessary for CircleCI Server users) |
| `circleci_ip_ranges` | boolean | false | Enables jobs to go through a set of well-defined IP address ranges. |
| `configuration_path` | string |  | The path to the configuration that will be passed to the continue API |
| `executor` | executor | default | Executor where this job will run. The executor requires curl, jq, and bash. |
| `parameters` | string | {} | The parameters used for the pipeline. This can either be a JSON object containing parameters or a path to a file containing a JSON object with parameters |
| `resource_class` | string | small | Resource class to use |
| `workspace_path` | string |  | Path to attach the workspace to |

## Executors

### default

The executor for continuations


| Parameter | Type | Default | Description |
|---|---|---|---|
| `tag` | string | stable | Pick a specific circleci/base image variant: https://hub.docker.com/r/cimg/base/tags
 |

## Examples

### continue_pipeline

Utilize the "continue" job to specify which configuration file to run next.


```yaml
version: '2.1'
setup: true
orbs:
  continuation: circleci/continuation@0.5.0
workflows:
  use-my-orb:
    jobs:
      - continuation/continue:
          configuration_path: .circleci/continue_config.yml
```

### continue_pipeline_with_parameters

Utilize the "continue" job to specify which configuration file to run next and add additional parameters.


```yaml
version: '2.1'
setup: true
orbs:
  continuation: circleci/continuation@0.5.0
workflows:
  use-my-orb:
    jobs:
      - continuation/continue:
          configuration_path: .circleci/continue_config.yml
          parameters: '{"image-tag":"current"}'
```