/circleci-pipelines | Type: Application | PCID required: Yes
Tools
circleci_pipelines_approve_pending_approval_job_by_id
Approve a job Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
approval_request_id | string | Yes | — | The ID of the job being approved. |
id | string | Yes | — | The unique ID of the workflow. |
circleci_pipelines_cancel_job_by_job_id
Cancel job by job ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
job-id | string | Yes | — | The unique ID of the job. |
circleci_pipelines_cancel_job_by_job_number
Cancel job by job number Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
job-number | object | Yes | — | The number of the job. |
project-slug | string | Yes | — | Project slug in the form vcs-slug/org-name/repo-name. The / characters may be URL-escaped. For projects that use GitLab or GitHub App, use circleci as the vcs-slug, replace org-name with the organization ID (found in Organization Settings), and replace repo-name with the project ID (found in Project Settings). |
circleci_pipelines_cancel_workflow
Cancel a workflow Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | The unique ID of the workflow. |
circleci_pipelines_continue_pipeline
Continue a pipeline Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
configuration | string | Yes | — | A configuration string for the pipeline. |
continuation-key | string | Yes | — | A pipeline continuation key. |
parameters | object | No | — | An object containing pipeline parameters and their values. Pipeline parameters have the following size limits: 100 max entries, 128 maximum key length, 512 maximum value length. |
circleci_pipelines_create_pipeline_definition
Create pipeline definition Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | An opaque identifier of a project. |
checkout_source | object | Yes | — | The resource to be used when running the checkout command. |
config_source | object | Yes | — | Config Source |
description | string | No | — | The description of the pipeline definition. |
name | string | Yes | — | The name of the pipeline definition. |
circleci_pipelines_create_schedule
Create a schedule Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project-slug | string | Yes | — | Project slug in the form vcs-slug/org-name/repo-name. The / characters may be URL-escaped. For projects that use GitLab or GitHub App, use circleci as the vcs-slug, replace org-name with the organization ID (found in Organization Settings), and replace repo-name with the project ID (found in Project Settings). |
attribution-actor | string | Yes | — | The attribution-actor of the scheduled pipeline. |
description | string | No | — | Description of the schedule. |
name | string | Yes | — | Name of the schedule. |
parameters | object | Yes | — | Pipeline parameters represented as key-value pairs. Must contain branch or tag. |
timetable | object | Yes | — | Timetable that specifies when a schedule triggers. |
circleci_pipelines_create_trigger
Create trigger Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | An opaque identifier of a project. |
pipeline_definition_id | string | Yes | — | An opaque identifier of a pipeline definition. |
checkout_ref | string | No | — | The ref to use when checking out code for pipeline runs created from this trigger. Always required when event_source.provider is webhook or schedule. When event_source.provider is github_app or github_server, only expected if the event source repository (identified by event_source.repo.external_id) is different to the checkout source repository of the associated Pipeline Definition. Otherwise, must be omitted. |
config_ref | string | No | — | The ref to use when fetching config for pipeline runs created from this trigger. Always required when event_source.provider is webhook or schedule. When event_source.provider is github_app or github_server, only expected if the event source repository (identified by event_source.repo.external_id) is different to the config source repository of the associated Pipeline Definition. Otherwise, must be omitted. |
disabled | boolean | No | — | Whether the trigger should be disabled upon creation. Not supported for triggers where event_source.provider is github_oauth. |
event_name | string | No | — | The name of the triggering event. Required when provider is webhook or schedule. Should not be set for other providers. |
event_preset | string | No | — | The name of the event preset to use when filtering events for this trigger. Only applicable when event_source.provider is github_app or github_server. |
event_source | object | Yes | — | The source of events to use for this trigger. The repo object must be specified when provider is github_app, github_server, or github_oauth, the webhook object may only be specified when provider is webhook, and the schedule object must be specified when provider is schedule. |
parameters | object | No | — | Pipeline parameters to pass when running pipelines from this trigger. Currently only supported for triggers where event_source.provider is schedule. |
circleci_pipelines_delete_pipeline_definition
Delete pipeline definition Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | An opaque identifier of a project. |
pipeline_definition_id | string | Yes | — | An opaque identifier of a pipeline definition. |
circleci_pipelines_delete_schedule_by_id
Delete a schedule Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
schedule-id | string | Yes | — | The unique ID of the schedule. |
circleci_pipelines_delete_trigger
Delete trigger Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | An opaque identifier of a project. |
trigger_id | string | Yes | — | An opaque identifier of a trigger. |
circleci_pipelines_get_component
Get Component Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
component_id | string | Yes | — | An opaque identifier of a component. |
circleci_pipelines_get_environment
Get Environment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
environment_id | string | Yes | — | An opaque identifier of an environment. |
circleci_pipelines_get_job
Get a job Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
job_id | string | Yes | — | An opaque identifier of a job. |
circleci_pipelines_get_job_artifacts
Get a job’s artifacts Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
job-number | object | Yes | — | The number of the job. |
project-slug | string | Yes | — | Project slug in the form vcs-slug/org-name/repo-name. The / characters may be URL-escaped. For projects that use GitLab or GitHub App, use circleci as the vcs-slug, replace org-name with the organization ID (found in Organization Settings), and replace repo-name with the project ID (found in Project Settings). |
circleci_pipelines_get_job_details
Get job details Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
job-number | object | Yes | — | The number of the job. |
project-slug | string | Yes | — | Project slug in the form vcs-slug/org-name/repo-name. The / characters may be URL-escaped. For projects that use GitLab or GitHub App, use circleci as the vcs-slug, replace org-name with the organization ID (found in Organization Settings), and replace repo-name with the project ID (found in Project Settings). |
circleci_pipelines_get_pipeline_by_id
Get a pipeline by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pipeline-id | string | Yes | — | The unique ID of the pipeline. |
circleci_pipelines_get_pipeline_by_number
Get a pipeline by pipeline number Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project-slug | string | Yes | — | Project slug in the form vcs-slug/org-name/repo-name. The / characters may be URL-escaped. For projects that use GitLab or GitHub App, use circleci as the vcs-slug, replace org-name with the organization ID (found in Organization Settings), and replace repo-name with the project ID (found in Project Settings). |
pipeline-number | object | Yes | — | The number of the pipeline. |
circleci_pipelines_get_pipeline_config_by_id
Get a pipeline’s configuration Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pipeline-id | string | Yes | — | The unique ID of the pipeline. |
circleci_pipelines_get_pipeline_definition
Get pipeline definition Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | An opaque identifier of a project. |
pipeline_definition_id | string | Yes | — | An opaque identifier of a pipeline definition. |
circleci_pipelines_get_pipeline_values_by_id
Get pipeline values for a pipeline Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pipeline_id | string | Yes | — | An opaque identifier of a pipeline. |
circleci_pipelines_get_schedule_by_id
Get a schedule by ID. Available only on schedules associated with GitHub OAuth or Bitbucket Cloud pipeline definitions. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
schedule-id | string | Yes | — | The unique ID of the schedule. |
circleci_pipelines_get_tests
Get test metadata Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
job-number | object | Yes | — | The number of the job. |
project-slug | string | Yes | — | Project slug in the form vcs-slug/org-name/repo-name. The / characters may be URL-escaped. For projects that use GitLab or GitHub App, use circleci as the vcs-slug, replace org-name with the organization ID (found in Organization Settings), and replace repo-name with the project ID (found in Project Settings). |
circleci_pipelines_get_trigger
Get trigger Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | An opaque identifier of a project. |
trigger_id | string | Yes | — | An opaque identifier of a trigger. |
circleci_pipelines_get_workflow_by_id
Get a workflow Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | The unique ID of the workflow. |
circleci_pipelines_list_component_versions
List Component Versions Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
component_id | string | Yes | — | An opaque identifier of a component. |
environment-id | string | No | — | An opaque identifier of an environment used in query parameters. |
circleci_pipelines_list_components
List Components Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
org-id | string | Yes | — | An opaque identifier of an organization used in query parameters. |
project-id | string | No | — | An opaque identifier of an project used in query parameters. |
page-size | integer | Yes | — | The number of results per page. |
page-token | string | No | — | A token to specify which page of results to fetch. |
circleci_pipelines_list_environments
List Environments Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
org-id | string | Yes | — | An opaque identifier of an organization used in query parameters. |
page-size | integer | Yes | — | The number of results per page. |
page-token | string | No | — | A token to specify which page of results to fetch. |
circleci_pipelines_list_my_pipelines
Get your pipelines Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project-slug | string | Yes | — | Project slug in the form vcs-slug/org-name/repo-name. The / characters may be URL-escaped. For projects that use GitLab or GitHub App, use circleci as the vcs-slug, replace org-name with the organization ID (found in Organization Settings), and replace repo-name with the project ID (found in Project Settings). |
page-token | string | No | — | A token to retrieve the next page of results. |
circleci_pipelines_list_pipeline_definition_triggers
List pipeline definition triggers Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | An opaque identifier of a project. |
pipeline_definition_id | string | Yes | — | An opaque identifier of a pipeline definition. |
circleci_pipelines_list_pipeline_definitions
List pipeline definitions Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | An opaque identifier of a project. |
circleci_pipelines_list_pipelines
Get a list of pipelines Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
org-slug | string | No | — | Org slug in the form vcs-slug/org-name. For projects that use GitLab or GitHub App, use circleci as the vcs-slug and replace the org-name with the organization ID (found in Organization Settings). |
page-token | string | No | — | A token to retrieve the next page of results. |
mine | boolean | No | — | Only include entries created by your user. |
circleci_pipelines_list_pipelines_for_project
Get all pipelines Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project-slug | string | Yes | — | Project slug in the form vcs-slug/org-name/repo-name. The / characters may be URL-escaped. For projects that use GitLab or GitHub App, use circleci as the vcs-slug, replace org-name with the organization ID (found in Organization Settings), and replace repo-name with the project ID (found in Project Settings). |
branch | string | No | — | The name of a vcs branch. |
page-token | string | No | — | A token to retrieve the next page of results. |
circleci_pipelines_list_schedules_for_project
List schedule triggers Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project-slug | string | Yes | — | Project slug in the form vcs-slug/org-name/repo-name. The / characters may be URL-escaped. For projects that use GitLab or GitHub App, use circleci as the vcs-slug, replace org-name with the organization ID (found in Organization Settings), and replace repo-name with the project ID (found in Project Settings). |
page-token | string | No | — | A token to retrieve the next page of results. |
circleci_pipelines_list_workflow_jobs
Get a workflow’s jobs Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | The unique ID of the workflow. |
circleci_pipelines_list_workflows_by_pipeline_id
Get a pipeline’s workflows Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pipeline-id | string | Yes | — | The unique ID of the pipeline. |
page-token | string | No | — | A token to retrieve the next page of results. |
circleci_pipelines_rerun_workflow
Rerun a workflow Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | The unique ID of the workflow. |
enable_ssh | boolean | No | — | Whether to enable SSH access for the triggering user on the newly-rerun job. Requires the jobs parameter to be used and so is mutually exclusive with the from_failed parameter. |
from_failed | boolean | No | — | Whether to rerun the workflow from the failed job. Mutually exclusive with the jobs parameter. |
jobs | string[] | No | — | A list of job IDs to rerun. |
sparse_tree | boolean | No | — | Completes rerun using sparse trees logic, an optimization for workflows that have disconnected subgraphs. Requires jobs parameter and so is mutually exclusive with the from_failed parameter. |
circleci_pipelines_rollback_project
Rollback a project Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | An opaque identifier of a project. |
component_name | string | Yes | — | The component name |
current_version | string | Yes | — | The current version |
environment_name | string | Yes | — | The environment name |
namespace | string | No | — | The namespace |
parameters | object | No | — | The extra parameters for the rollback pipeline |
reason | string | No | — | The reason for the rollback |
target_version | string | Yes | — | The target version |
circleci_pipelines_trigger_pipeline
Trigger a new pipeline Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project-slug | string | Yes | — | Project slug in the form vcs-slug/org-name/repo-name. The / characters may be URL-escaped. For projects that use GitLab or GitHub App, use circleci as the vcs-slug, replace org-name with the organization ID (found in Organization Settings), and replace repo-name with the project ID (found in Project Settings). |
branch | string | No | — | The branch where the pipeline ran. The HEAD commit on this branch was used for the pipeline. Note that branch and tag are mutually exclusive. To trigger a pipeline for a PR by number use pull/<number>/head for the PR ref or pull/<number>/merge for the merge ref (GitHub only). |
parameters | object | No | — | An object containing pipeline parameters and their values. Pipeline parameters have the following size limits: 100 max entries, 128 maximum key length, 512 maximum value length. |
tag | string | No | — | The tag used by the pipeline. The commit that this tag points to was used for the pipeline. Note that branch and tag are mutually exclusive. |
circleci_pipelines_trigger_pipeline_run
[Recommended] Trigger a new pipeline Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
provider | string | Yes | — | The first segment of the slash-separated project slug, as shown in Project Settings > Overview. |
organization | string | Yes | — | The second segment of the slash-separated project slug, as shown in Project Settings > Overview. Depending on the organization type, this may be the org name (e.g. my-org) or an ID (e.g. 43G3lM5RtfFE7v5sa4nWAU). |
project | string | Yes | — | The third segment of the slash-separated project slug, as shown in Project Settings > Overview. Depending on the organization type, this may be the project name (e.g. my-project) or an ID (e.g. 44n9wujWcTnVZ2b5S8Fnat). |
checkout | object | No | — | The checkout value |
config | object | No | — | The config value |
definition_id | string | No | — | The unique id for the pipeline definition. This can be found in the page Project Settings > Pipelines. |
parameters | object | No | — | An object containing pipeline parameters and their values. Pipeline parameters have the following size limits: 100 max entries, 128 maximum key length, 512 maximum value length. |
circleci_pipelines_update_pipeline_definition
Update pipeline definition Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | An opaque identifier of a project. |
pipeline_definition_id | string | Yes | — | An opaque identifier of a pipeline definition. |
checkout_source | object | No | — | The resource to be used when running the checkout command. |
config_source | object | No | — | The resource that stores the CircleCI config YAML used for this pipeline definition. |
description | string | No | — | The description of the pipeline definition. |
name | string | No | — | The name of the pipeline definition. |
circleci_pipelines_update_schedule
Update a schedule Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
schedule-id | string | Yes | — | The unique ID of the schedule. |
attribution-actor | string | No | — | The attribution-actor of the scheduled pipeline. |
description | string | No | — | Description of the schedule. |
name | string | No | — | Name of the schedule. |
parameters | object | No | — | Pipeline parameters represented as key-value pairs. Must contain branch or tag. |
timetable | object | No | — | Timetable that specifies when a schedule triggers. |
circleci_pipelines_update_trigger
Update trigger Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | An opaque identifier of a project. |
trigger_id | string | Yes | — | An opaque identifier of a trigger. |
checkout_ref | string | No | — | The ref to use when checking out code for pipeline runs created from this trigger. |
config_ref | string | No | — | The ref to use when fetching config for pipeline runs created from this trigger. |
disabled | boolean | No | — | A flag indicating whether the trigger is disabled or not. Not supported for triggers where event_source.provider is github_oauth. |
event_name | string | No | — | The name of the triggering event. Required when provider is webhook or schedule. Should not be set for other providers. |
event_preset | string | No | — | The name of the event preset to use when filtering events for this trigger. Only applicable when event_source.provider is github_app or github_server. |
event_source | object | No | — | Event Source |
parameters | object | No | — | Pipeline parameters to pass when running pipelines from this trigger. Currently only supported for triggers where event_source.provider is schedule. |

