get_build_history_report
Retrieve a paginated build history report with optional filters (date range, build profile, organization) for monitoring and analysis.
Instructions
Get build history report, optionally filtered by date range.
Retrieves paginated build history with build metadata, artifacts, duration, status, and optional filters by date range, build profile and organization. Called without start_date and end_date, returns every item in the report.
IMPORTANT: Results are paginated by default to prevent token limit issues. Default page size is 50 items. Use page parameter to retrieve additional results.
Args: start_date: Optional start date (format: "YYYY-MM-DD", e.g., "2024-01-01") end_date: Optional end date (format: "YYYY-MM-DD", e.g., "2024-12-31") page: Page number (starts from 1, default: 1) size: Items per page (1-100, default: 50) build_profile_name: Filter by build profile name organization_id: Filter by organization UUID
Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of build history records), meta (count, page, page_size, total_count, total_pages, has_more, next_page, filters). - Error: success (false), error (tool, type, message, details).
Examples: Get all build history (no date filter): get_build_history_report()
Get build history for last month:
get_build_history_report(
start_date="2024-11-01",
end_date="2024-11-30"
)
Filter by build profile:
get_build_history_report(
start_date="2024-01-01",
end_date="2024-12-31",
build_profile_name="RN076iOS"
)
Get second page with custom size:
get_build_history_report(
start_date="2024-01-01",
end_date="2024-12-31",
page=2,
size=25
)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| size | No | ||
| end_date | No | ||
| start_date | No | ||
| organization_id | No | ||
| build_profile_name | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |