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"
}
}
}
Builds
Get Build Details
Retrieve details for a specific build.
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-storagePath Parameters
string
required
The build ID (UUID)
Response
The response includes all fields from the List Builds Build object, plus additional detail fields.object
Build metadata (VCS, CI, app info)
Show details properties
Show details properties
object
object
CI/CD metadata (system, build_number, job_name, run_url)
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
API key for authentication
Path Parameters
The build ID (UUID)
The project ID. You can copy it from the project settings page or the project URL in the dashboard.
Response
Successful response
Unique identifier for the build
Build name
Target platform
Build status (e.g., OK, UNHEALTHY)
Original file name
File size in bytes
Whether the build is pinned (protected from auto-deletion)
Whether the build includes nunu SDK integration
Tags associated with this build
Timestamp when the build was created
Timestamp when the build was last used in a run
Build description
Optional build metadata
Show child attributes
Show child attributes