Builds
List Builds
Retrieve a paginated list of builds for your project.
GET
Permission Required:
project:manage-build-storageQuery Parameters
Filter by build status (e.g.,
OK, UNHEALTHY)Filter by pinned status:
true for pinned builds only, false for non-pinned onlyFilter by nunu SDK integration:
true for SDK builds only, false for non-SDK onlyFilter by platform:
windows, android, ios-nativeFilter by tags (comma-separated). All specified tags must match. Example:
tags=release,candidatePage number (0-indexed)
Results per page (1-100)
Response
Array of build objects
Pagination information
Build Object
Unique identifier for the build (UUID)
Build name
Target platform
Build status:
uploading, ready, failedOriginal 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
ISO 8601 timestamp when the build was created
ISO 8601 timestamp when the build was last used in a run
Build description
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