Unified Project Lifecycle APIs

Bulk delete project files

Bulk deletes project files and preserves generated 200 or 207 bulk-operation statuses.

Features:

  • Accepts up to 250 file identifiers per batch request (connect-portal's configured maximum).
  • Returns per-file results so partial failures do not abort the entire batch.

Use Cases:

  • VS Code extension deletes multiple files selected in the explorer.
  • User prunes generated files no longer referenced by the project.

Authorization: Requires replication-pipeline::delete when permission harmonization is enabled; otherwise, replication-pipeline::manage.

post/v1/integration/projects/{projectId}/files/batch-delete

Request

  • Base URL: https://integration-adapter.connect.cloud.precisely.com
  • URL: https://integration-adapter.connect.cloud.precisely.com/v1/integration/projects/{projectId}/files/batch-delete
  • Auth: HTTP bearer

Path parameters

projectIdstring required

Unique identifier of the project

Query parameters

projectType'REPLICATION' | 'MAINFRAME_REPLICATION' | 'ADVANCED_REPLICATION' required

Supported project types for unified project operations

Project type (required for routing): REPLICATION | MAINFRAME_REPLICATION | ADVANCED_REPLICATION

pipelineIdstring

Unique identifier of the Mainframe Replication pipeline (Mainframe Replication only). Ignored for Advanced Replication.

revisionNumberinteger

Optional revision number targeted by the batch delete

Request body

fileIdsstring[] required

Unique identifiers of the files to delete, up to 250 per request

Example request

{
  "fileIds": [
    "file-002",
    "file-003"
  ]
}

Response

All files deleted successfully

Example response

{
  "results": [
    {
      "fileId": "file-002",
      "successful": true,
      "metadata": {
        "fileId": "file-002",
        "fileName": "customers.dis.yaml",
        "flattenedPath": "sources/customers.dis.yaml",
        "version": 1,
        "mimeType": "application/yaml",
        "encoding": "utf-8",
        "sizeBytes": 512
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.