Builds
Get build
Get detailed information about a specific build. Includes ios_info, android_info, primary_file, expansion_files, and metadata_artifacts when available. Requires builds:read scope.
GET
/applications/{application_id}/builds/{build_id}Authorization
bearerAuth AuthorizationBearer <token>
API key. Bearer authentication header of the form Bearer <token>, where <token> is your Workspace or Application API key.
In: header
Path Parameters
application_id*string
Application ID.
build_id*string
Build ID.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.comapplications/aBc1234/builds/xYz9876" \ -H "Authorization: Bearer YOUR_API_KEY"{ "message": "Build retrieved successfully.", "data": { "id": "xYz9876", "build_structure": "file", "version": "1.0.1", "version_short": "1.0.1", "version_semantic_major": 1, "version_semantic_minor": 0, "version_semantic_patch": 1, "version_semantic_extra": null, "version_semantic_meta": null, "build_number": "398", "platform": { "identifier": "windows", "name": "Windows", "short_name": "Windows", "upload_instruction": "Upload a .exe, .msi, or .zip installer." }, "stream": { "id": "stR4567", "name": "nightlies", "description": "Nightly development builds", "retention_days": 30, "created_at": "2025-06-10T09:15:00.000000Z", "updated_at": "2025-06-15T14:30:00.000000Z" }, "labels": [ { "id": "lbl1234", "name": "Production", "description": "Production-ready builds", "color": "#22c55e", "level": "application", "created_at": "2025-06-10T09:15:00.000000Z", "updated_at": "2025-06-15T14:30:00.000000Z" } ], "architectures": [ { "identifier": "x64", "name": "x64", "description": "64-bit x86 (AMD64 / Intel 64)" }, { "identifier": "arm64v8", "name": "ARM64v8", "description": "ARMv8-A 64-bit" } ], "notes": "Example build notes here.", "size_total_bytes": 52428800, "size_total_string": "50.00 MB", "metadata_total_bytes": 4096, "build_source": "ghactions", "ci_pipeline": { "ci_pipeline_name": "Nightly Build", "ci_pipeline_url": "https://github.com/buildstash/example/actions/workflows/nightly.yml", "ci_run_id": "12345678901", "ci_run_url": "https://github.com/buildstash/example/actions/runs/12345678901", "ci_build_duration": "00:05:00" }, "scm": { "scm_host_type": "git", "scm_host": "github", "scm_repo_name": "buildstash/example", "scm_repo_url": "https://github.com/buildstash/example", "scm_branch": "main", "scm_commit_sha": "1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6", "scm_commit_sha_short": "1a2b3c4", "scm_commit_url": "https://github.com/buildstash/example/commit/1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6" }, "pending": false, "modal_url": "https://acme.buildstash.com/applications/aBc1234/builds/xYz9876", "download_url": "https://acme.buildstash.com/builds/xYz9876/download", "built_at": "2025-06-15T14:30:00.000000Z", "created_at": "2025-06-10T09:15:00.000000Z", "updated_at": "2025-06-15T14:30:00.000000Z", "application_id": "aBc1234", "workspace_id": "wSp1234", "primary_file": { "id": "550e8400-e29b-41d4-a716-446655440003", "filename": "example.exe", "size_bytes": 52428800, "size_string": "50.00 MB", "checksum_md5": "d41d8cd98f00b204e9800998ecf8427e", "filetype": { "identifier": "exe", "name": "Windows Executable", "extension": "exe" }, "created_at": "2025-06-10T09:15:00.000000Z", "updated_at": "2025-06-15T14:30:00.000000Z" }, "expansion_files": [], "metadata_artifacts": [ { "id": "550e8400-e29b-41d4-a716-446655440002", "filename": "Info.plist", "size_bytes": 4096, "size_string": "4.00 KB", "checksum_md5": "098f6bcd4621d373cade4e832627b4f6", "metadata_filetype": { "identifier": "info-plist", "name": "Info.plist", "extension": "plist" }, "created_at": "2025-06-10T09:15:00.000000Z", "updated_at": "2025-06-15T14:30:00.000000Z" } ], "ios_info": null, "android_info": null }}{ "message": "Unauthorized"}{ "message": "This action requires 'resource:action' scope."}