get_commits_by_branch
Retrieve paginated commits for a build branch, providing commit hash, message, author, and build details.
Instructions
Get commits for a build branch (paginated).
Returns a list of commits for the given branch ID, including commit hash, message, author, commit date, tags, and associated builds. When page and size are provided, the API returns pagination metadata (page, perPage, pageCount, totalCount, enablePrevious, enableNext) which is included in meta.
Args: branch_id: The branch ID (e.g. UUID). page: Page number (1-based). If provided with size, enables pagination and returns pagination metadata in meta. Default when using pagination: 1. size: Page size. If provided with page, enables pagination. Default when using pagination: 25. Values above 100 are capped at 100.
Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of commit objects with id, hash, message, author, email, commitDate, tags, builds, etc.), meta (when pagination used: page, page_size, page_count, total_count, enable_previous, enable_next; otherwise empty or minimal). - Error: success (false), error (tool, type, message, details).
Examples: Get commits (no pagination): get_commits_by_branch(branch_id="branch-uuid") Get first page of commits: get_commits_by_branch(branch_id="branch-uuid", page=1, size=25) Get page 2 with 10 items: get_commits_by_branch(branch_id="branch-uuid", page=2, size=10)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| size | No | ||
| branch_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |