# \BuildsApi

All URIs are relative to *https://registry.example.com*

Method | HTTP request | Description
------------- | ------------- | -------------
[**diff_builds**](BuildsApi.md#diff_builds) | **GET** /api/v1/builds/diff | Compare two builds
[**get_build**](BuildsApi.md#get_build) | **GET** /api/v1/builds/{id} | Get build
[**list_build_artifacts**](BuildsApi.md#list_build_artifacts) | **GET** /api/v1/builds/{id}/artifacts | List build artifacts
[**list_builds**](BuildsApi.md#list_builds) | **GET** /api/v1/builds | List builds



## diff_builds

> models::DiffBuilds200Response diff_builds(build1, build2)
Compare two builds

Returns a diff showing artifacts added, removed, or changed between two builds.

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**build1** | **uuid::Uuid** | First build ID. | [required] |
**build2** | **uuid::Uuid** | Second build ID. | [required] |

### Return type

[**models::DiffBuilds200Response**](diffBuilds_200_response.md)

### Authorization

[apiKeyAuth](../README.md#apiKeyAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## get_build

> models::Build get_build(id)
Get build

Returns detailed information about a single build.

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**id** | **uuid::Uuid** | Build UUID | [required] |

### Return type

[**models::Build**](Build.md)

### Authorization

[apiKeyAuth](../README.md#apiKeyAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## list_build_artifacts

> Vec<models::Artifact> list_build_artifacts(id)
List build artifacts

Returns all artifacts associated with the specified build.

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**id** | **uuid::Uuid** | Build UUID | [required] |

### Return type

[**Vec<models::Artifact>**](Artifact.md)

### Authorization

[apiKeyAuth](../README.md#apiKeyAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## list_builds

> models::ListBuilds200Response list_builds(page, per_page)
List builds

Returns a paginated list of recent builds.

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**page** | Option<**i32**> | Page number for pagination |  |[default to 1]
**per_page** | Option<**i32**> | Number of items per page |  |[default to 20]

### Return type

[**models::ListBuilds200Response**](listBuilds_200_response.md)

### Authorization

[apiKeyAuth](../README.md#apiKeyAuth), [bearerAuth](../README.md#bearerAuth)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)

