Get project staging status - Precisely Data Integrity Suite

Data Integrity Suite APIs
Product
Data_Integrity
Spatial_Analytics
Data_Enrichment
geo_addressing_1
Services
Spatial Analytics
Data Enrichment
Geo Addressing
ft:title
Data Integrity Suite APIs
ft:locale
en-US
PublicationType
pt_developer
copyrightfirst
2023
copyrightlast
2026

Retrieves the staging status of a project.

HTML

GET https://hostname/v1/integration/continuous/projects/{projectId}/staging/status

Process overview

  • This endpoint checks the current staging status of the specified project.
  • If the project is active, the response includes the redirect URL in the Location header.
  • Otherwise, it returns the current staging status.

Key features

  • Enables users to monitor the staging progress of a project.
  • Provides both the staging status and the redirect URL for active projects.

Required permissions

replication-pipeline::view

Request

Path parameters

Key Required Type Description
projectId Yes string

The unique identifier of the project for which staging status has to be retrieved.

Response

If the project is active, the response includes the redirect URL in the Location header while also returning the current staging status in the response body. This allows clients to handle the redirect manually while still receiving the staging status.

Header keys

Key Required Type Value Description
Location No string Redirect URL

Redirect URL to the project alerts endpoint if the project is active.

Example: /projects/project-123/alerts

Response body properties

Ancestors Property Required Type Description
  projectId No string Unique identifier of the project for which the status is retrieved.
  validation No object Validation status details of the project.
validation status No string Current status of the validation process.
validation message No string Message providing additional details about the validation status.
validation completePercentage No integer Percentage of validation process completed.
validation result No object Detailed results of the validation process.
validation/result severityLevel No string Severity level of the validation result.
validation/result message No string Validation message providing additional details.
validation/result warning No integer Number of warnings encountered during validation.
validation/result incomplete No integer Number of incomplete validations.
validation/result error No integer Number of errors encountered during validation.
validation/result fatal No integer Number of fatal errors encountered during validation.
validation/result total No integer Total number of validation issues encountered.
validation lastUpdated No string Timestamp of the last update to the validation status.
  staging No object Staging status details of the project.
staging status No string Current status of the staging process.
staging committed No boolean Indicates whether the project has been committed.
staging message No string Message providing additional details about the staging status.
staging result No object Detailed results of the staging process.
staging/result severityLevel No string Severity level of the validation result.
staging/result message No string Validation message providing additional details.
staging/result warning No integer Number of warnings encountered during validation.
staging/result incomplete No integer Number of incomplete validations.
staging/result error No integer Number of errors encountered during validation.
staging/result fatal No integer Number of fatal errors encountered during validation.
staging/result total No integer Total number of validation issues encountered.
  lastUpdated No string Timestamp of the last update to the staging status.

Response examples

{
  "projectId": "project-123",
  "validation": {
    "status": "OPEN",
    "message": "string",
    "completePercentage": 0,
    "result": {
      "severityLevel": "VALID",
      "message": "string",
      "warning": 0,
      "incomplete": 0,
      "error": 0,
      "fatal": 0,
      "total": 0
    },
    "lastUpdated": "2025-10-01T12:00:00Z"
  },
  "staging": {
    "status": "OPEN",
    "committed": true,
    "message": "string",
    "result": {
      "severityLevel": "VALID",
      "message": "string",
      "warning": 0,
      "incomplete": 0,
      "error": 0,
      "fatal": 0,
      "total": 0
    },
    "lastUpdated": "2025-10-01T12:00:00Z"
  }
}
 
{
  "type": "https://datatracker.ietf.org/doc/html/rfc9110#section-15.5.1",
  "title": "Bad Request",
  "status": 400,
  "detail": "Validation error occurred",
  "instance": "/v1/integration/continuous/projects/{projectId}/staging/status",
  "properties": {
    "errorCode": "DI-ADAPTER-VAL-0000"
  }
}
 
{
  "type": "https://datatracker.ietf.org/doc/html/rfc9110#section-15.5.2",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Authorization failed - missing or invalid credentials",
  "instance": "/v1/integration/continuous/projects/{projectId}/staging/status",
  "properties": {
    "errorCode": "DI-ADAPTER-AUT-0001"
  }
}
 
{
  "type": "https://datatracker.ietf.org/doc/html/rfc9110#section-15.5.4",
  "title": "Forbidden",
  "status": 403,
  "detail": "Authorization failed - insufficient permissions",
  "instance": "/v1/integration/continuous/projects/{projectId}/staging/status",
  "properties": {
    "errorCode": "DI-ADAPTER-AUT-0002"
  }
}
 
{
  "type": "https://datatracker.ietf.org/doc/html/rfc9110#section-15.5.5",
  "title": "Not Found",
  "status": 404,
  "detail": "Not Found - Resource does not exist",
  "instance": "/v1/integration/continuous/projects/{projectId}/staging/status",
  "properties": {
    "errorCode": "DI-ADAPTER-PRJ-0005"
  }
}
 
{
  "type": "https://datatracker.ietf.org/doc/html/rfc9110#section-15.6",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected error occurred",
  "instance": "/v1/integration/continuous/projects/{projectId}/staging/status",
  "properties": {
    "errorCode": "DI-ADAPTER-COM-0001"
  }
}