Get Build Details

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"

{
  "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"
    }
  }
}

GET

project

{projectId}

builds

{buildId}

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"

{
  "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)

Show details properties

details.vcs

object

Version control metadata

Show vcs properties

details.vcs.type

string

VCS type: git, mercurial, svn

details.vcs.provider

string

Provider: github, gitlab, bitbucket, azure-devops

details.vcs.branch

string

Branch name

details.vcs.commit

object

Commit info (hash, short_hash, message, author, timestamp)

details.ci

object

CI/CD metadata (system, build_number, job_name, run_url)

details.app

object

App metadata (version, version_code, build_number, bundle_id)

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"

{
  "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)

projectId

string

required

The project ID. You can copy it from the project settings page or the project URL in the dashboard.

Response

Successful response

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

​Path Parameters

​Response

Authorizations

Path Parameters

Response

Path Parameters

Response