Get Releases
GET/api/v1/catalog/releases/project/:projectIdentifier
This service message allows retrieval of releases.
Request
Path Parameters
Project identifier (ID or name)
Header Parameters
Responses
- 200
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
metadata
object
Enable automatic deployment of this release
postInstallAction
object
Post-installation action configuration
Possible values: [NONE, WEB, EXE]
Action type: NONE (no action), WEB (open URL), or EXE (run executable)
URL to open (required when type is WEB)
Executable path to run (required when type is EXE)
Installation size in bytes - disk space required after installation (user-specified)
Total size in bytes - automatically calculated as installationSize + artifactsSize
Hide this release from agents if the health check URL is not healthy
URL to check for health status. Required when hideIfNotHealthy is true.
Interval in seconds between health check requests. Required when healthCheckUrl is set.
Possible values: [draft, in_review, approved, released, archived, error]
draft: Release is still being prepared.
in_review: Submitted for review, not yet approved.
approved: Approved but not yet released.
released: Actively released and deployable.
archived: No longer active.
error: Release was previously released but one or more artifacts are missing from storage. Requires a user with edit-released-release permission to resolve.
Total number of required regulations
Total number of compliant regulations
Indicates if this release was imported from another system
Indicates if this release is read-only. A release is read-only when its status is released or error and the current user does not have the edit-released-release permission.
[
{
"id": "string",
"version": "string",
"projectName": "string",
"projectId": 0,
"name": "string",
"releaseNotes": "string",
"metadata": {
"autoDeploy": true,
"postInstallAction": {
"type": "NONE",
"url": "string",
"exePath": "string"
},
"installationSize": 0,
"totalSize": 0,
"hideIfNotHealthy": true,
"healthCheckUrl": "string",
"healthCheckIntervalSeconds": 0
},
"status": "draft",
"createdAt": "2026-06-22T12:47:52.248Z",
"updatedAt": "2026-06-22T12:47:52.248Z",
"requiredRegulationsCount": 0,
"compliantRegulationsCount": 0,
"latest": true,
"releasedAt": "2026-06-22T12:47:52.248Z",
"createdBy": "string",
"updatedBy": "string",
"isImported": true,
"readonly": true
}
]