Get a list of all image builds (composes) with their UUIDs and basic status.
image-builder__get_composesRetrieve a list of image builds with UUIDs and status. Use this to find your build and get the UUID for detailed information.
Instructions
Get a list of all image builds (composes) with their UUIDs and basic status.
ALWAYS USE THIS FIRST when checking image build status or finding builds. This returns the UUID needed for get_compose_details. 🟢 CALL IMMEDIATELY - No information gathering required.
Common uses:
Check status of recent builds → call this first
Find your latest build → call this first
Get any build information → call this first Ask the user if they want to get more composes and adapt "offset" accordingly.
You can also provide this link so the user can check directly in the UI: https://console.redhat.com/insights/image-builder
Returns: List of composes with: - uuid: The unique identifier (REQUIRED for get_compose_details) - name: Blueprint name used - status: Current build status - created_at: When the build started
Example response: [ { "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "name": "my-rhel-image", "status": "RUNNING", "created_at": "2025-01-18T10:30:00Z" } ]
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of items to return (use 7 as default) | |
| offset | No | Number of items to skip when paging (use 0 as default) | |
| search_string | No | Substring to search for in the name |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |