Advanced DSL Project Management

Create a DSL file

Creates a new DSL file asset in the project using multipart/form-data upload.

Features

  • Creates a brand-new file asset in the catalog.
  • Initializes file version to 1 for all newly created files.
  • Persists content, hash, size, MIME type, encoding, and phase metadata.
  • Links the file to the selected revision via Includes relationship.
  • When revisionNumber is omitted, links against the latest project revision.

Use Cases

  • Adding a newly authored DSL file to a project.
  • Creating a file before first inclusion in a revision.
  • Programmatic project bootstrap with initial file assets.

Scenarios

  • New file create + explicit revisionNumber → file is created and linked to that revision.
  • New file create + no revisionNumber → file is created and linked to latest revision.
  • File created but already linked to target revision → no duplicate relationship is created.

Required Permissions: replication-pipeline::create when permission harmonization is enabled; otherwise, replication-pipeline::manage.

post/v1/integration/advanced-dsl/projects/{projectId}/files

Request

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

Path parameters

projectIdstring required

Unique project identifier

Query parameters

mimeTypestring

MIME type of the file content

encodingstring

Encoding applied to the content

phasestring

Target lifecycle phase to apply after save

flattenedPathstring

Flattened path of the file within the project (e.g., pipelines/customer-sync.dis.yaml). Defaults to file name if omitted.

revisionNumberinteger

Optional revision number to associate the file with. If omitted, latest project revision is used.

Response

File created successfully

fileIdstring

Catalog asset ID of the saved file

namestring

The base name of the saved file

flattenedPathstring

The flattened path of the saved file

phasestring

The current lifecycle phase of the file after save

versioninteger

The version of the file after save

timestampstring date-time

Server timestamp when the save was processed

Example response

{
  "fileId": "file-abc123",
  "name": "customer-sync.dis.yaml",
  "flattenedPath": "pipelines/customer-sync.dis.yaml",
  "phase": "DRAFT",
  "version": 3,
  "timestamp": "2026-05-17T10:00:00Z"
}

Changes

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