curl -X GET "https://nunu.ai/api/v1/project/your-project-id/deployment-configs?page=0&page_size=25" \
-H "X-Api-Key: YOUR_API_TOKEN"
{
"data": [
{
"id": "456e7890-e89b-12d3-a456-426614174000",
"name": "Android prod",
"description": "Build storage based android deployment",
"kind": "android",
"pinned": true,
"provider_type": "build-storage",
"allow_multi_device_runs": true,
"device_labels": ["Galaxy S24"],
"summary": {
"target_label": "Galaxy S24",
"deployment_config_id": "456e7890-e89b-12d3-a456-426614174000",
"version": 3,
"name": "Android prod",
"description": "Build storage based android deployment",
"pinned": true,
"platform": "android",
"environment": "standard_android_device",
"sdk_mode": "sdk",
"app": {
"source": "build_storage",
"file_format": "file",
"required_tags": ["release"]
},
"extra_apps": [
{
"extra_app_number": 1,
"source": "build_storage",
"file_format": "zip",
"required_tags": ["companion"]
}
]
}
}
],
"pagination": {
"page": 0,
"page_size": 25,
"total_count": 1,
"total_pages": 1
}
}
Configs
List Deployment Configs
Retrieve a paginated list of deployment configurations for your project.
GET
/
project
/
{projectId}
/
deployment-configs
curl -X GET "https://nunu.ai/api/v1/project/your-project-id/deployment-configs?page=0&page_size=25" \
-H "X-Api-Key: YOUR_API_TOKEN"
{
"data": [
{
"id": "456e7890-e89b-12d3-a456-426614174000",
"name": "Android prod",
"description": "Build storage based android deployment",
"kind": "android",
"pinned": true,
"provider_type": "build-storage",
"allow_multi_device_runs": true,
"device_labels": ["Galaxy S24"],
"summary": {
"target_label": "Galaxy S24",
"deployment_config_id": "456e7890-e89b-12d3-a456-426614174000",
"version": 3,
"name": "Android prod",
"description": "Build storage based android deployment",
"pinned": true,
"platform": "android",
"environment": "standard_android_device",
"sdk_mode": "sdk",
"app": {
"source": "build_storage",
"file_format": "file",
"required_tags": ["release"]
},
"extra_apps": [
{
"extra_app_number": 1,
"source": "build_storage",
"file_format": "zip",
"required_tags": ["companion"]
}
]
}
}
],
"pagination": {
"page": 0,
"page_size": 25,
"total_count": 1,
"total_pages": 1
}
}
Permission Required:
project:view-configsdeployment_config_id values for
Start a Run and
Start Test Plan Run.
Query Parameters
integer
default:"0"
Page number (0-indexed)
integer
default:"25"
Results per page (1-100)
Response
DeploymentConfig[]
required
Array of deployment config objects
object
required
Pagination metadata (
page, page_size, total_count, total_pages)DeploymentConfig Object
string
required
Deployment config ID (use as
deployment_config_id when starting runs)string
required
Deployment config name
string
Optional description
string
required
Platform kind (e.g.
windows, macos, linux, android, ios,
xbox, playstation)boolean
required
Whether the config is pinned
string | null
Underlying build provider (e.g.
build-storage, direct-url), or null if
unknownboolean
Whether this config supports running on all configured devices
string[]
Labels for devices configured by this deployment config
object
Compact deployment metadata used to discover app build requirements. It
contains
target_label, deployment_config_id, version, name,
description, pinned, platform, environment, sdk_mode, app, and
extra_apps. app describes the main app. Each extra_apps entry includes
its one-based extra_app_number. App metadata may include source
(build_storage, skip_install, preinstalled, or read_only),
file_format (file or zip), and required_tags; read_only entries
include editable: false and a safe summary. This metadata omits credentials.curl -X GET "https://nunu.ai/api/v1/project/your-project-id/deployment-configs?page=0&page_size=25" \
-H "X-Api-Key: YOUR_API_TOKEN"
{
"data": [
{
"id": "456e7890-e89b-12d3-a456-426614174000",
"name": "Android prod",
"description": "Build storage based android deployment",
"kind": "android",
"pinned": true,
"provider_type": "build-storage",
"allow_multi_device_runs": true,
"device_labels": ["Galaxy S24"],
"summary": {
"target_label": "Galaxy S24",
"deployment_config_id": "456e7890-e89b-12d3-a456-426614174000",
"version": 3,
"name": "Android prod",
"description": "Build storage based android deployment",
"pinned": true,
"platform": "android",
"environment": "standard_android_device",
"sdk_mode": "sdk",
"app": {
"source": "build_storage",
"file_format": "file",
"required_tags": ["release"]
},
"extra_apps": [
{
"extra_app_number": 1,
"source": "build_storage",
"file_format": "zip",
"required_tags": ["companion"]
}
]
}
}
],
"pagination": {
"page": 0,
"page_size": 25,
"total_count": 1,
"total_pages": 1
}
}
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
Page number (0-indexed)
Results per page (1-100)
Required range:
1 <= x <= 100