---
title: TLS Activations
summary: TLS activations.
url: >-
  https://www.fastly.com/documentation/reference/api/tls/custom-certs/activations
---

TLS activations.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `relationships.tls_certificate.id` | string | Alphanumeric string identifying a TLS certificate. |
| `relationships.tls_configuration.id` | string | Alphanumeric string identifying a TLS configuration. |
| `relationships.tls_domain.id` | string | The domain name. |
| `type` | string | Resource type. |
| `created_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `deleted_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `id` | string | Alphanumeric string identifying a TLS activation. (Read-only) |
| `updated_at` | string | Date and time in ISO 8601 format. (Read-only) |

## API endpoints

### List TLS activations

**GET** `/tls/activations`

List all TLS activations.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `filter[tls_certificate.id]` | string | query | No | Limit the returned activations to a specific certificate. |
| `filter[tls_configuration.id]` | string | query | No | Limit the returned activations to a specific TLS configuration. |
| `filter[tls_domain.id]` | string | query | No | Limit the returned rules to a specific domain name. |
| `include` | string | query | No | Include related objects. Optional, comma-separated values. Permitted values: <code>tls_certificate</code>, <code>tls_configuration</code>, and <code>tls_domain</code>. |
| `page[number]` | integer | query | No | Current page. |
| `page[size]` | integer | query | No | Number of records per page. |

### Enable TLS for a domain using a custom certificate

**POST** `/tls/activations`

Enable TLS for a particular TLS domain and certificate combination. These relationships must be specified to create the TLS activation.

### Get a TLS activation

**GET** `/tls/activations/{tls_activation_id}`

Show a TLS activation.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `include` | string | query | No | Include related objects. Optional, comma-separated values. Permitted values: <code>tls_certificate</code>, <code>tls_configuration</code>, and <code>tls_domain</code>. |
| `tls_activation_id` | string | path | Yes | Alphanumeric string identifying a TLS activation. |

### Disable TLS on a domain

**DELETE** `/tls/activations/{tls_activation_id}`

Disable TLS on the domain associated with this TLS activation.

**Parameters:**

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

### Update a certificate

**PATCH** `/tls/activations/{tls_activation_id}`

Update the certificate used to terminate TLS traffic for the domain associated with this TLS activation.

**Parameters:**

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