Releases
Get release
Get detailed information about a specific release. Requires releases:read scope.
GET
/applications/{application_id}/releases/{release_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.
release_id*string
Release ID.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.comapplications/aBc1234/releases/rLs4567" \ -H "Authorization: Bearer YOUR_API_KEY"{ "message": "Release retrieved successfully.", "data": { "id": "rLs4567", "version": "1.0.0", "version_short": "1.0.0", "version_semantic_major": 1, "version_semantic_minor": 0, "version_semantic_patch": 0, "version_semantic_extra": null, "version_semantic_meta": null, "title": "Initial Release", "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" } ], "build_count": 3, "created_at": "2025-06-10T09:15:00.000000Z", "updated_at": "2025-06-15T14:30:00.000000Z", "notes": "## What's new\n\n- First public release\n- Bug fixes and improvements", "builds": [ { "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" }}{ "message": "Unauthorized"}{ "message": "This action requires 'resource:action' scope."}