Skip to main content
GET
/
builds
/
{buildId}
curl -X GET "https://nunu.ai/api/v1/builds/123e4567-e89b-12d3-a456-426614174000" \
  -H "X-Api-Key: YOUR_API_TOKEN"
{
  "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"
    }
  }
}
Permission Required: project:manage-build-storage
Retrieve details for a specific build.

Path Parameters

buildId
string
required
The build ID (UUID)

Response

The response includes all fields from the List Builds Build object, plus additional detail fields.
details
object
Build metadata (VCS, CI, app info)
curl -X GET "https://nunu.ai/api/v1/builds/123e4567-e89b-12d3-a456-426614174000" \
  -H "X-Api-Key: YOUR_API_TOKEN"
{
  "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"
    }
  }
}

Authorizations

X-Api-Key
string
header
required

API key for authentication

Path Parameters

buildId
string<uuid>
required

The build ID (UUID)

Response

Successful response

id
string<uuid>

Unique identifier for the build

name
string

Build name

platform
string

Target platform

status
string

Build status (e.g., OK, UNHEALTHY)

file_name
string

Original file name

file_size
integer

File size in bytes

pinned
boolean

Whether the build is pinned (protected from auto-deletion)

nunu_sdk
boolean

Whether the build includes nunu SDK integration

tags
string[]

Tags associated with this build

created_at
string<date-time>

Timestamp when the build was created

last_used
string<date-time> | null

Timestamp when the build was last used in a run

description
string | null

Build description

details
object

Optional build metadata