Advanced DSL Project Management

Pull project files

Retrieves DSL project files with optional content for a pull operation.

Features:

  • Pull latest or specific revision
  • Optional content inclusion for offline editing
  • Selective field projection via relatedAssetFields
  • Content is base64-encoded when includeContent=true

Use Cases:

  • Initial project pull (includeContent=true)
  • Pre-push metadata check (includeContent=false)
  • Historical revision retrieval

Scenarios:

  • Full pull of latest revision for local workspace hydration
  • Selective pull via assetIds for targeted downloads
  • Metadata-only pull to compare before push

Required Permissions: replication-pipeline::view

get/v1/integration/advanced-dsl/projects/{projectId}/pull

Request

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

Path parameters

projectIdstring required

Unique project identifier

Query parameters

revisionNumberinteger

Specific revision number to pull (default: latest)

includeContentboolean

Whether to include base64-encoded file content (default: true)

relatedAssetFieldsstring[]

Optional list of related asset fields to include

assetIdsstring[]

When provided, fetch only these specific file assets by catalog asset ID (Phase 2 selective download)

Response

Successfully retrieved project files

revisionIdstring

The revision ID from which files are being pulled

revisionNumberinteger

The revision number from which files are being pulled

includeContentboolean

Whether file content is included in the response

totalCountinteger

Total number of files in the project

Example response

{
  "revisionId": "rev-abc123",
  "revisionNumber": 3,
  "files": [
    {
      "catalogAssetId": "asset-file-001",
      "flattenedPath": "pipelines/customer-sync.dis.yaml",
      "name": "customer-sync.dis.yaml",
      "version": 2,
      "phase": "approved",
      "contentHash": "e3b0c44298fc1c149afbf4c8996fb924...",
      "sizeBytes": 2048,
      "mimeType": "application/x-yaml",
      "encoding": "utf-8",
      "createdAt": "2026-05-10T08:30:00Z",
      "updatedAt": "2026-05-15T14:20:00Z",
      "createdBy": "john.doe@example.com",
      "updatedBy": "jane.smith@example.com",
      "catalogLink": "https://catalog.precisely.com/assets/asset-file-001"
    }
  ],
  "includeContent": true,
  "totalCount": 12
}

Changes

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