---
title: "List project revisions"
method: GET
path: "/v1/integration/advanced-dsl/projects/{projectId}/revisions"
tags: ["Advanced DSL Project Management"]
---

# List project revisions

`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

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`

## Path parameters

- `projectId` string, required

## Query parameters

- `page` integer
- `size` integer
- `sort` string[]

## Response `200`

Successfully retrieved revision list

- RevisionPageResponse: Paginated response containing a list of DSL project revisions with navigation metadata
  - `content` RevisionRecord[]: List of revision records in the current page
    - `revisionId` string: Unique identifier of the revision
    - `revisionNumber` integer: Sequential revision number
    - `baseRevisionNumber` integer: The base revision number this revision was based on (null for initial revision)
    - `fileCount` integer: Number of files included in this revision
    - `createdAt` string, date-time: Timestamp when this revision was created
    - `createdBy` string: User who created this revision
    - `description` string: Optional description or commit message for this revision
  - `pageNumber` integer: Zero-based page number
  - `pageSize` integer: Number of items per page (requested size)
  - `numberOfElements` integer: Actual number of revisions in the current page
  - `totalElements` integer: Total number of revisions across all pages
  - `totalPages` integer: Total number of pages available
  - `first` boolean: Indicates if this is the first page
  - `last` boolean: Indicates if this is the last page

## Other responses

- `400`: Bad request — invalid pagination or sorting input
- `401`: Unauthorized — authentication required
- `403`: Forbidden — user lacks 'replication-pipeline::view' permission
- `404`: Project not found
- `500`: Internal server error during revision listing

---

[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)