---
title: "Trigger diagnostic bundle operations"
method: POST
path: "/v1/integration/continuous/monitoring/projects/{projectId}/diagnostic-bundles/trigger"
tags: ["Monitor and Trigger Continuous Integration Projects"]
---

# Trigger diagnostic bundle operations

`POST /v1/integration/continuous/monitoring/projects/{projectId}/diagnostic-bundles/trigger`

## Request

- Base URL: `https://integration-adapter.connect.cloud.precisely.com`
- URL: `https://integration-adapter.connect.cloud.precisely.com/v1/integration/continuous/monitoring/projects/{projectId}/diagnostic-bundles/trigger`
- Auth: HTTP bearer

Submits a request to start or stop diagnostic bundles.
Start Diagnostic bundle request collects and packages logs from various on-prem components for troubleshooting and diagnostic purposes.
Supports START to initiate bundle creation and STOP to cancel ongoing bundles.
A 202 Accepted response indicates the request was validated and dispatched.

Process Overview:
- For START: Validate bundle name and optional description, then dispatch start request to initiate bundling.
- For STOP: Dispatch stop request to cancel ongoing packaging.

Key Features:
- START action to initiate diagnostic bundle creation with optional description.
- STOP action to cancel ongoing diagnostic bundle packaging.
- Uniform 202 response indicating request acceptance.
- Immediate monitoring path via Location header for tracking bundle status.

**Required Permissions:** `replication-pipeline::operate`

## Path parameters

- `projectId` string, required

## Request body

- TriggerDiagnosticBundleRequest: Request to start or stop diagnostic bundles.
  - `bundleName` string, required: The name to identify the diagnostic bundle
  - `description` string: A description for the diagnostic bundle
  - `action` 'START' | 'STOP', required: Action to perform: START to initiate bundle creation, STOP to cancel ongoing bundle creation.

## Response `202`

Accepted. Location header points to status endpoint.

## Other responses

- `400`: Invalid request payload
- `401`: Unauthorized - Authentication required
- `403`: Forbidden - User lacks 'replication-pipeline::operate' permission
- `404`: Not Found - Resource does not exist
- `500`: Internal Server Error - Failed to submit trigger request

---

[API](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service.md) · [All operations](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service/revisions/2d2629f4987d?raw)