> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.nunu.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Build Details
> Retrieve details for a specific build.
**Permission Required**: `project:manage-build-storage`
Retrieve details for a specific build.
## Path Parameters
The build ID (UUID)
## Response
The response includes all fields from the [List Builds](/api-reference/builds/list-builds) Build object, plus additional detail fields.
Build metadata (VCS, CI, app info)
Version control metadata
VCS type: `git`, `mercurial`, `svn`
Provider: `github`, `gitlab`, `bitbucket`, `azure-devops`
Branch name
Commit info (hash, short\_hash, message, author, timestamp)
CI/CD metadata (system, build\_number, job\_name, run\_url)
App metadata (version, version\_code, build\_number, bundle\_id)
```bash cURL theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
curl -X GET "https://nunu.ai/api/v1/project/your-project-id/builds/123e4567-e89b-12d3-a456-426614174000" \
-H "X-Api-Key: YOUR_API_TOKEN"
```
```json 200 theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Production Build v1.2.3",
"platform": "android",
"status": "OK",
"file_name": "app-release.apk",
"file_size": 52428800,
"pinned": true,
"nunu_sdk": true,
"tags": ["version:1.2.3", "env:production"],
"created_at": "2026-03-03T15:50:19.544603+00:00",
"last_used": "2026-03-10T10:30:00.000000+00:00",
"description": "Release build for production",
"details": {
"vcs": {
"type": "git",
"provider": "github",
"branch": "main",
"commit": {
"hash": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0",
"short_hash": "a1b2c3d",
"message": "Release v1.2.3",
"author": "developer@example.com",
"timestamp": "2026-03-03T14:30:00.000000+00:00"
}
},
"ci": {
"system": "github-actions",
"build_number": "456",
"job_name": "build-release",
"run_url": "https://github.com/org/repo/actions/runs/123456"
},
"app": {
"version": "1.2.3",
"version_code": 123,
"build_number": "456",
"bundle_id": "com.example.app"
}
}
}
```
## OpenAPI
````yaml GET /project/{projectId}/builds/{buildId}
openapi: 3.1.0
info:
title: nunu.ai API
description: >-
The nunu.ai Public API allows you to programmatically interact with your
projects, manage test runs, and upload builds.
version: 1.0.0
servers:
- url: https://nunu.ai/api/v1
security:
- apiKeyAuth: []
paths:
/project/{projectId}/builds/{buildId}:
parameters:
- name: projectId
in: path
required: true
schema:
type: string
description: >-
The project ID. You can copy it from the project settings page or the
project URL in the dashboard.
get:
tags:
- Builds
summary: Get Build Details
description: Retrieve details for a specific build.
operationId: getBuild
parameters:
- name: buildId
in: path
required: true
description: The build ID (UUID)
schema:
type: string
format: uuid
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/BuildWithDetails'
'401':
description: Unauthorized - Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden - API key lacks required permission
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Build not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
BuildWithDetails:
allOf:
- $ref: '#/components/schemas/Build'
- type: object
properties:
details:
$ref: '#/components/schemas/BuildDetails'
Error:
type: object
properties:
error:
type: string
code:
type: string
details:
type: object
Build:
type: object
properties:
id:
type: string
format: uuid
description: Unique identifier for the build
name:
type: string
description: Build name
platform:
type: string
description: Target platform
status:
type: string
description: Build status (e.g., OK, UNHEALTHY)
file_name:
type: string
description: Original file name
file_size:
type: integer
description: File size in bytes
pinned:
type: boolean
description: Whether the build is pinned (protected from auto-deletion)
nunu_sdk:
type: boolean
description: Whether the build includes nunu SDK integration
tags:
type: array
items:
type: string
description: Tags associated with this build
created_at:
type: string
format: date-time
description: Timestamp when the build was created
last_used:
type: string
format: date-time
nullable: true
description: Timestamp when the build was last used in a run
description:
type: string
nullable: true
description: Build description
BuildDetails:
type: object
description: Optional build metadata
properties:
vcs:
type: object
properties:
type:
type: string
enum:
- git
- mercurial
- svn
provider:
type: string
enum:
- github
- gitlab
- bitbucket
- azure-devops
repository_url:
type: string
commit:
type: object
properties:
hash:
type: string
short_hash:
type: string
message:
type: string
author:
type: string
timestamp:
type: string
branch:
type: string
tag:
type: string
pr:
type: object
properties:
number:
type: integer
title:
type: string
url:
type: string
source_branch:
type: string
target_branch:
type: string
ci:
type: object
properties:
system:
type: string
enum:
- github-actions
- jenkins
- gitlab-ci
- circleci
- travis
- azure-pipelines
- bitrise
- custom
build_number:
type: string
job_name:
type: string
run_id:
type: string
run_url:
type: string
triggered_by:
type: string
agent:
type: string
app:
type: object
properties:
version:
type: string
version_code:
type: integer
build_number:
type: string
bundle_id:
type: string
build:
type: object
properties:
configuration:
type: string
enum:
- debug
- release
- staging
- production
timestamp:
type: string
duration:
type: integer
compiler:
type: string
dependencies:
type: object
upload:
type: object
properties:
method:
type: string
enum:
- cli
- api
- github-action
- jenkins-plugin
- web
cli_version:
type: string
uploader:
type: string
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: X-Api-Key
description: API key for authentication
````