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."}