---
title: "Get the running release"
method: GET
path: "/v1/projects/{project_id}/releases/current"
tags: ["Deployments"]
---

# Get the running release

`GET /v1/projects/{project_id}/releases/current`

## Request

- Base URL: `https://api.liara.ir`
- URL: `https://api.liara.ir/v1/projects/{project_id}/releases/current`
- Auth: HTTP bearer

Returns the release that's running now, or `null` if there is none. Team permission: any project permission.

## Path parameters

- `project_id` string, required

## Query parameters

- `teamID` string: 24-character hexadecimal ID.

## Response `200`

The running release. The response can include additional fields not listed here.

- object
  - `currentRelease` Release
    - `_id` string
    - `tag` string: The release's number, for example `v3`.
    - `type` 'DEPLOY' | 'ENV_UPDATE' | 'ROLLBACK' | 'AUTO_ROLLBACK': `DEPLOY`: a normal deployment. `ENV_UPDATE`: a redeploy after environment variables changed. `ROLLBACK`: a rollback you started. `AUTO_ROLLBACK`: a rollback started automatically.
    - `state` 'PENDING' | 'BUILDING' | 'DEPLOYING' | 'READY' | 'CANCELED' | 'FAILED' | 'TIMEDOUT' | 'UNHEALTHY'
    - `failReason` string: Why the release failed, if it did.
    - `projectType` 'node' | 'next' | 'react' | 'vue' | 'angular' | 'static' | 'laravel' | 'php' | 'django' | 'flask' | 'python' | 'netcore' | 'dotnet' | 'go' | 'docker': The app's platform.
    - `port` integer
    - `message` string
    - `gitInfo` object
    - `client` string: The tool that created the release.
    - `rollbackedTo` object: For rollbacks, the release that was restored.
      - `tag` string
    - `buildLocation` 'iran' | 'germany'
    - `buildTimeout` integer: Maximum build time, in minutes.
    - `maxImageLayerSize` integer
    - `sourceAvailable` boolean: Whether the source code can still be downloaded with `POST /v2/releases/{releaseID}/source`.
    - `queue` integer: Only for `PENDING` releases. How many releases are waiting to be built before this one.
    - `platformConfig` object: The platform settings the release was built with.
    - `disks` DiskMount[]
      - `name` string, required: Name of one of the app's disks.
      - `mountTo` string, required: Where to mount it. Relative paths are relative to your app's root directory; `docker` apps must use absolute paths. Can't be `/`.
    - `createdAt` string, date-time
    - `finishedAt` string, date-time, nullable

## Other responses

- `400`: `teamID` isn't a valid ID.
- `401`: The API token is missing, invalid or expired.
- `403`: With `teamID`: you aren't a member of the team (`team_not_found`), or you don't have the required permission on this app (`no_permission`).
- `404`: The app doesn't exist.

## Changes

- **2026-11-02** `610162e8a623`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/liara-cloud/apis/paas/changes/v1/projects/:project_id/releases/current/get.md)

---

[API](https://skmtc.dev/liara-cloud/apis/paas.md) - [All operations](https://skmtc.dev/liara-cloud/apis/paas/llms.txt) - [OpenAPI document](https://skmtc.dev/liara-cloud/apis/paas/revisions/610162e8a623?raw)