# HttpBuildCache

API Documentation: | `HttpBuildCache`

Note: This class is incubating and may change in a future version of Gradle.

Configuration object for the HTTP build cache. The build cache only supports BASIC authentication currently.

Cache entries are loaded via GET and stored via PUT requests.

For a GET request we expect a 200 or 404 response and for PUT we expect any 2xx response. Other responses are treated as recoverable or non-recoverable errors, depending on the status code. E.g. we treat authentication failures (401 and 409) as non-recoverable while an internal server error (500) is recoverable.

### Properties

Property | Description
`enabled` | Incubating Whether the build cache is enabled.
`push` | Incubating Whether pushing to the build cache is enabled.
`url` | Incubating The URI to the cache.

### Methods

Method | Description
`credentials(configuration)` | Incubating Configures the credentials used to access the HTTP cache backend.

### Script blocks

No script blocks

### Property details

#### `boolean` `enabled`

Note: This property is incubating and may change in a future version of Gradle.

Whether the build cache is enabled.

#### `boolean` `push`

Note: This property is incubating and may change in a future version of Gradle.

Whether pushing to the build cache is enabled.

#### `URI` `url`

Note: This property is incubating and may change in a future version of Gradle.

The URI to the cache.

### Method details

#### `void` `credentials`(``Action`<? super `HttpBuildCacheCredentials`>` configuration)

Note: This method is incubating and may change in a future version of Gradle.

Configures the credentials used to access the HTTP cache backend.