---
title: "Get build logs"
method: GET
path: "/v2/releases/{releaseID}/build-logs"
tags: ["Deployments"]
---

# Get build logs

`GET /v2/releases/{releaseID}/build-logs`

## Request

- Base URL: `https://api.liara.ir`
- URL: `https://api.liara.ir/v2/releases/{releaseID}/build-logs`
- Auth: HTTP bearer

Returns up to 20 lines of a release's build output, with the release's current state. To follow a build, call it repeatedly with `since` set to the `createdAt` of the last line you received. Team permission: any project permission.

## Path parameters

- `releaseID` string, required: 24-character hexadecimal ID.

## Query parameters

- `teamID` string: 24-character hexadecimal ID.
- `since` string, date-time

## Response `200`

Build output.

- object
  - `release` object
    - `_id` string
    - `state` 'PENDING' | 'BUILDING' | 'DEPLOYING' | 'READY' | 'CANCELED' | 'FAILED' | 'TIMEDOUT' | 'UNHEALTHY'
    - `failReason` string
  - `buildOutput` object[]
    - `_id` string
    - `line` string
    - `stream` 'STDOUT' | 'STDERR'
    - `releaseID` string
    - `createdAt` string, date-time

## 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 release doesn't exist.

## Changes

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

[Operation history](https://skmtc.dev/liara-cloud/apis/paas/changes/v2/releases/:releaseID/build-logs/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)