Delete pipeline runs

If your project contains failed or canceled pipeline runs, you can delete them.You can delete a maximum of 32 pipeline runs in a batch deletion operation.

When you initiate a pipeline run deletion, the status of the pipeline run changestoBeing deleted. After the pipeline run remains in this status for an hour,Vertex AI Pipelines queues it for permanent deletion. Subsequently, adaily scheduled operation permanently removes all pipeline runs queued forpermanent deletion.

Delete a pipeline run

To delete a pipeline run, use the Google Cloud console, the REST API, or theVertex AI SDK for Python.

Console

Use the following instructions to delete an ongoing pipeline run from the Google Cloud console:

  1. In the Vertex AI section, go to theRuns tab on thePipelines page.

    Go to Runs

  2. Select the checkbox next to a canceled or failed pipeline run that youwant to delete.
  3. ClickDelete. This option is available only if the pipelinerun is in theFailed orCanceled status.

After you clickDelete, the status of the pipeline run changes toBeing deleted, before it's permanently deleted.

REST

To delete an ongoing or scheduled pipeline run, send aDELETE requestby using thepipelineJobs.deletemethod.

Before using any of the request data, make the following replacements:

  • LOCATION: The region where the pipeline run is located. For more information about the regions where Vertex AI Pipelines is available, see theVertex AI locations guide.
  • PROJECT_ID: The Google Cloud project containing the pipeline run.
  • PIPELINE_RUN_ID: The unique ID of the pipeline run that you want to delete. The pipeline run ID is displayed in theRuns tab on thePipelines page in the Google Cloud console.

HTTP method and URL:

DELETE https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID

To send your request, choose one of these options:

curl

Note: The following command assumes that you have logged in to thegcloud CLI with your user account by runninggcloud init orgcloud auth login , or by usingCloud Shell, which automatically logs you into thegcloud CLI . You can check the currently active account by runninggcloud auth list.

Execute the following command:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID"

PowerShell

Note: The following command assumes that you have logged in to thegcloud CLI with your user account by runninggcloud init orgcloud auth login . You can check the currently active account by runninggcloud auth list.

Execute the following command:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID" | Select-Object -Expand Content

You should receive a JSON response similar to the following:

{  "name": "projects/PROJECT_NUMBER/locations/us-central1/operations/OPERATION_ID",  "metadata": {    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteOperationMetadata",    "genericMetadata": {      "createTime": "2025-07-25T16:23:47.201943Z",      "updateTime": "2025-07-25T16:23:47.201943Z"    }  },  "done": true,  "response": {    "@type": "type.googleapis.com/google.protobuf.Empty"  }}

Python

Use the following sample to delete a failed or cancelled pipeline run byusing thePipelineJob.delete method:

fromgoogle.cloudimportaiplatformaiplatform.init(project="PROJECT_ID",location="LOCATION")pipeline_job=aiplatform.PipelineJob.get(resource_name="PIPELINE_RUN_ID")pipeline_job.delete()

Replace the following:

  • PROJECT_ID: The Google Cloud project containing the pipeline run.
  • LOCATION: The region where the pipeline run is located. For more information about the regions where Vertex AI Pipelines is available, see theVertex AI locations guide.
  • PIPELINE_RUN_ID with the unique ID of the pipeline run that you want to delete. The ID is displayed in theRuns tab on thePipelines page in theGoogle Cloud console.

Delete multiple pipeline runs

To delete multiple failed or cancelled pipeline runs simultaneously, use theGoogle Cloud console, the REST API, or the Vertex AI SDK for Python. You can batchdelete pipeline runs that are in the same project and region.

Console

Use the following instructions to delete multiple ongoing pipeline run from the Google Cloud console:

  1. In the Vertex AI section, go to theRuns tab on thePipelines page.

    Go to Runs

  2. Select the checkboxes next to the canceled or failed pipeline runs that youwant to delete.
  3. ClickDelete. This option is available only if all of the selectedpipeline runs are in theFailed orCanceled status.

After you clickDelete, the status of the selected pipeline runs changes toBeing deleted, before the runs are permanently deleted.

REST

To batch delete multiple ongoing or scheduled pipeline runs, send aPOST requestby using thepipelineJobs.batchDeletemethod.

Before using any of the request data, make the following replacements:

  • LOCATION: The region where the pipeline runs are located. For more information about the regions where Vertex AI Pipelines is available, see theVertex AI locations guide.
  • PROJECT_ID: The Google Cloud project containing the pipeline runs.
  • PIPELINE_RUN_ID_1,PIPELINE_RUN_ID_2: The IDs of the pipeline jobs that you want to delete. You can find the job ID in theRuns tab on thePipelines page in the Google Cloud console.

HTTP method and URL:

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs:batchDelete

Request JSON body:

{  "names": [    "projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID_1",    "projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID_2"  ]}

To send your request, choose one of these options:

curl

Note: The following command assumes that you have logged in to thegcloud CLI with your user account by runninggcloud init orgcloud auth login , or by usingCloud Shell, which automatically logs you into thegcloud CLI . You can check the currently active account by runninggcloud auth list.

Save the request body in a file namedrequest.json, and execute the following command:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs:batchDelete"

PowerShell

Note: The following command assumes that you have logged in to thegcloud CLI with your user account by runninggcloud init orgcloud auth login . You can check the currently active account by runninggcloud auth list.

Save the request body in a file namedrequest.json, and execute the following command:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs:batchDelete" | Select-Object -Expand Content

You should receive a JSON response similar to the following:

{  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",  "metadata": {    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteOperationMetadata",    "genericMetadata": {      "createTime": "2025-05-31T16:07:12.233655Z",      "updateTime": "2025-05-31T16:07:12.233655Z"    }  },  "done": true,  "response": {    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.BatchDeletePipelineJobsResponse",    "pipelineJobs": [      {        "name": "projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID_1"      },      {        "name": "projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID_2"      }    ]  }}

Python

Use the following sample to delete multiple ongoing or scheduled pipeline runsby using thePipelineJob.batch_delete method:

fromgoogle.cloudimportaiplatform_v1fromgoogle.api_core.client_optionsimportClientOptionspipeline_run_ids_to_delete=["PIPELINE_RUN_ID_1","PIPELINE_RUN_ID_2",]client_options=ClientOptions(api_endpoint=f"LOCATION-aiplatform.googleapis.com")
pipeline_job_client=aiplatform_v1.PipelineServiceClient(client_options=client_options)pipeline_resource_names_to_delete=[]forrun_idinpipeline_run_ids_to_delete:full_resource_name=f"projects/PROJECT_NUMBER/locations/LOCATION/pipelineJobs/{run_id}"pipeline_resource_names_to_delete.append(full_resource_name)parent=f"projects/PROJECT_ID/locations/LOCATION"
pipeline_job_client.batch_delete_pipeline_jobs(parent=parent,names=pipeline_resource_names_to_delete)

Replace the following:

  • PROJECT_ID: Your project ID.
  • PROJECT_ID: The Google Cloud project containing the pipeline runs.
  • PROJECT_NUMBER: The project number for your project. You can locate this project number in the Google Cloud console. For more information, seeFind the project name, number, and ID.
  • PIPELINE_RUN_ID_1,PIPELINE_RUN_ID_2: The IDs of the pipeline jobs that you want to delete. The pipeline run IDs are displayed in theRuns tab on thePipelines page in the Google Cloud console.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-18 UTC.