---
title: "Provision SSL for a domain."
method: POST
path: "/v1/domains/{id}/ssl"
tags: ["Domains"]
---

# Provision SSL for a domain.

`POST /v1/domains/{id}/ssl`

## Request

- Base URL: `https://api.scalix.world`
- URL: `https://api.scalix.world/v1/domains/{id}/ssl`
- Auth: HTTP bearer

Starts background Let's Encrypt certificate issuance for a verified domain.
The domain must be active; automatic SSL must be configured on the deployment.

## Path parameters

- `id` string, required

## Response `200`

SSL provisioning started

- ProvisionSslResponse: Response for `POST /v1/domains/{id}/ssl`.
  - `domain` string, required
  - `ssl_status` string, required
  - `message` string, required

## Other responses

- `400`: Domain not verified yet
- `401`: Missing or invalid credentials
- `404`: Domain not found
- `500`: Internal error
- `501`: Automatic SSL not configured on this deployment

---

[API](https://skmtc.dev/scalix/apis/scalix-cloud-api.md) · [All operations](https://skmtc.dev/scalix/apis/scalix-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scalix/apis/scalix-cloud-api/revisions/2c04ca0a90bb?raw)