Advanced DSL Project Management

List project revisions

Retrieves a paginated list of project revisions sorted in descending order by revision number.

Features:

  • Page-based pagination with configurable size
  • Sortable by revisionNumber, createdAt, createdBy, description
  • Includes revision metadata (creator, timestamp, description, file count)

Use Cases:

  • Version history display in VS Code extension
  • Rollback point selection
  • Audit trail inspection

Scenarios:

  • Pagination through long revision history
  • Sorted timeline view by revision number or creation metadata
  • Investigation of who changed what and when

Required Permissions: replication-pipeline::view

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

Request

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

Path parameters

projectIdstring required

Unique project identifier

Query parameters

pageinteger

Zero-based page index (0..N).

Validation Rules:

  • Must be greater than or equal to 0
  • Default: 0 (first page)

Examples:

  • page=0 (first page)
  • page=1 (second page)
  • page=5 (sixth page)
sizeinteger

The number of items to return per page.

Validation Rules:

  • Must be between 1 and 100 (inclusive)
  • Default: 10 items per page
  • Values exceeding 100 will return validation error

Examples:

  • size=10 (10 items per page)
  • size=50 (50 items per page)
  • size=100 (maximum allowed)
sortstring[]

Sorting criteria with flexible format options. Multiple sort parameters supported for multi-level sorting.

Default: name,asc (sort by name in ascending order)

Sort Format Options:

  • sort=property (e.g., sort=name - defaults to ascending)
  • sort=property,direction (e.g., sort=name,asc or sort=createdAt,desc)
  • sort=property,asc,ignoreCase (for case-insensitive sorting)

Multi-level Sorting:

  • sort=property1,asc&sort=property2,desc (multiple sort parameters)
  • First sort criteria takes priority, subsequent ones used for tie-breaking

Note: Supported sort properties vary by endpoint. Check the specific endpoint documentation for the list of valid sort properties for that resource type.

Examples:

  • sort=name,asc (sort by name ascending)
  • sort=createdAt,desc (sort by creation date descending)
  • sort=type,asc&sort=name,asc (multi-level sort)
  • sort=deployedAt,desc,ignoreCase (case-insensitive sort)

Response

Successfully retrieved revision list

pageNumberinteger

Zero-based page number

pageSizeinteger

Number of items per page (requested size)

numberOfElementsinteger

Actual number of revisions in the current page

totalElementsinteger

Total number of revisions across all pages

totalPagesinteger

Total number of pages available

firstboolean

Indicates if this is the first page

lastboolean

Indicates if this is the last page

Example response

{
  "content": [
    {
      "revisionId": "rev-abc123",
      "revisionNumber": 3,
      "fileCount": 12,
      "createdAt": "2026-05-17T10:00:00Z",
      "createdBy": "john.doe@example.com",
      "description": "Updated customer-sync pipeline with new target schema"
    }
  ],
  "pageSize": 25,
  "numberOfElements": 2,
  "totalElements": 3,
  "totalPages": 1,
  "first": true
}

Changes

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