product_create_build
Creates a new CI/CD pipeline build entry in Spira, recording build results and associating commits with a specific release.
Instructions
Creates a new CI/CD pipeline build entry in Spira.
Maps to Spira API: POST /projects/{product_id}/releases/{release_id}/builds
Use this to record CI/CD build results and associate commits with releases.
Args:
product_id: The numeric ID of the product (e.g., 55 for PR:55). If omitted, uses SPIRA_PROJECT_ID from environment.
release_id: Release/sprint ID without RL prefix (e.g., 12 for RL:12)
build_status_id: Build status (1=Failed, 2=Passed)
name: Build name (typically project name + date/time)
description: Detailed build description (what was included and why)
commits: Array of Git commit hashes included in the build
Returns:
JSON: {"build_id": "BL:123", "message": "Build created successfully"}
Error Responses:
Returns structured JSON with error, error_code, details, and suggestion.
Common error codes: INVALID_PARAMETER, API_ERROR, NOT_FOUND
Example Usage:
result = create_build(
product_id=55, release_id=10, build_status_id=2,
name="Build 2024-02-13 v1.5.0", description="Production build",
commits=["abc123", "def456"]
)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| release_id | Yes | ||
| build_status_id | Yes | ||
| name | Yes | ||
| description | Yes | ||
| commits | Yes | ||
| product_id | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |