---
title: TLS Configuration
summary: >-
  Customers with access to multiple sets of IP pools are able to apply different
  configuration options to their TLS enabled domains.
url: https://www.fastly.com/documentation/reference/api/tls/configuration
---

Customers with access to multiple sets of IP pools are able to apply different configuration options to their TLS enabled domains.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `name` | string | A custom name for your TLS configuration. |
| `relationships.dns_records.id` | string | The IP address or hostname of the DNS record. |
| `relationships.service.id` | string | Alphanumeric string identifying the service. |
| `type` | string | Resource type. |
| `bulk` | boolean | Signifies whether the configuration is used for Platform TLS or not. (Read-only) |
| `created_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `default` | boolean | Signifies whether or not Fastly will use this configuration as a default when creating a new <a href="https://www.fastly.com/documentation/reference/api/tls/custom-certs/activations/">TLS Activation</a>. (Read-only) |
| `deleted_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `http_protocols` | array | HTTP protocols available on your configuration. (Read-only) |
| `id` | string | Alphanumeric string identifying a TLS configuration. (Read-only) |
| `tls_protocols` | array | TLS protocols available on your configuration. (Read-only) |
| `updated_at` | string | Date and time in ISO 8601 format. (Read-only) |

## API endpoints

### List TLS configurations

**GET** `/tls/configurations`

List all TLS configurations.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `filter[bulk]` | string | query | No | Optionally filters by the bulk attribute. |
| `include` | string | query | No | Include related objects. Optional, comma-separated values. Permitted values: <code>dns_records</code>. |
| `page[number]` | integer | query | No | Current page. |
| `page[size]` | integer | query | No | Number of records per page. |

### Get a TLS configuration

**GET** `/tls/configurations/{tls_configuration_id}`

Show a TLS configuration.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `include` | string | query | No | Include related objects. Optional, comma-separated values. Permitted values: <code>dns_records</code>. |
| `tls_configuration_id` | string | path | Yes | Alphanumeric string identifying a TLS configuration. |

### Update a TLS configuration

**PATCH** `/tls/configurations/{tls_configuration_id}`

Update a TLS configuration.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `tls_configuration_id` | string | path | Yes | Alphanumeric string identifying a TLS configuration. |