curl -X GET "https://nunu.ai/api/v1/project/your-project-id/builds?status=ready&platform=android&page=0&page_size=10" \
-H "X-Api-Key: YOUR_API_TOKEN"
const response = await fetch(
"https://nunu.ai/api/v1/project/your-project-id/builds?status=ready&platform=android&page=0&page_size=10",
{
headers: {
"X-Api-Key": process.env.NUNU_API_TOKEN,
},
}
);
const data = await response.json();
import requests
import os
response = requests.get(
"https://nunu.ai/api/v1/project/your-project-id/builds",
headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]},
params={"status": "ready", "platform": "android", "page": 0, "page_size": 10}
)
data = response.json()
{
"data": [
{
"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"
}
],
"pagination": {
"page": 0,
"page_size": 10,
"total_count": 25,
"total_pages": 3
}
}
Builds
List Builds
Retrieve a paginated list of builds for your project.
GET
/
project
/
{projectId}
/
builds
curl -X GET "https://nunu.ai/api/v1/project/your-project-id/builds?status=ready&platform=android&page=0&page_size=10" \
-H "X-Api-Key: YOUR_API_TOKEN"
const response = await fetch(
"https://nunu.ai/api/v1/project/your-project-id/builds?status=ready&platform=android&page=0&page_size=10",
{
headers: {
"X-Api-Key": process.env.NUNU_API_TOKEN,
},
}
);
const data = await response.json();
import requests
import os
response = requests.get(
"https://nunu.ai/api/v1/project/your-project-id/builds",
headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]},
params={"status": "ready", "platform": "android", "page": 0, "page_size": 10}
)
data = response.json()
{
"data": [
{
"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"
}
],
"pagination": {
"page": 0,
"page_size": 10,
"total_count": 25,
"total_pages": 3
}
}
Permission Required:
project:manage-build-storageQuery Parameters
string
Filter by build status (e.g.,
OK, UNHEALTHY)boolean
Filter by pinned status:
true for pinned builds only, false for non-pinned onlyboolean
Filter by nunu SDK integration:
true for SDK builds only, false for non-SDK onlystring
Filter by platform:
windows, android, ios-nativestring
Filter by tags (comma-separated). All specified tags must match. Example:
tags=release,candidateinteger
default:"0"
Page number (0-indexed)
integer
default:"20"
Results per page (1-100)
Response
Build[]
required
Array of build objects
object
required
Build Object
string
required
Unique identifier for the build (UUID)
string
required
Build name
string
required
Target platform
string
required
Build status:
uploading, ready, failedstring
required
Original file name
integer
required
File size in bytes
boolean
required
Whether the build is pinned (protected from auto-deletion)
boolean
required
Whether the build includes nunu SDK integration
string[]
required
Tags associated with this build
string
required
ISO 8601 timestamp when the build was created
string
ISO 8601 timestamp when the build was last used in a run
string
Build description
curl -X GET "https://nunu.ai/api/v1/project/your-project-id/builds?status=ready&platform=android&page=0&page_size=10" \
-H "X-Api-Key: YOUR_API_TOKEN"
const response = await fetch(
"https://nunu.ai/api/v1/project/your-project-id/builds?status=ready&platform=android&page=0&page_size=10",
{
headers: {
"X-Api-Key": process.env.NUNU_API_TOKEN,
},
}
);
const data = await response.json();
import requests
import os
response = requests.get(
"https://nunu.ai/api/v1/project/your-project-id/builds",
headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]},
params={"status": "ready", "platform": "android", "page": 0, "page_size": 10}
)
data = response.json()
{
"data": [
{
"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"
}
],
"pagination": {
"page": 0,
"page_size": 10,
"total_count": 25,
"total_pages": 3
}
}
Authorizations
API key for authentication
Path Parameters
The project ID. You can copy it from the project settings page or the project URL in the dashboard.
Query Parameters
Filter by build status (e.g., OK, UNHEALTHY)
Filter by pinned status
Filter by nunu SDK integration
Filter by platform
Available options:
windows, macos, linux, android, ios-native, ios-simulator, xbox, playstation Filter by tags (comma-separated). All specified tags must match.
Page number (0-indexed)
Results per page (1-100)
Required range:
1 <= x <= 100