# Mark a connection's certificate for renewal

> Mark a connection's certificate for renewal: CustomDomain™ API reference in the secure group. Covers parameters, request body, responses and error codes.

Source: https://docs.customdomain.ai/docs/api-reference/secure/renewConnectionCertificate

## `POST https://api.customdomain.ai/v1/connections/{id}/ssl:renew`

Records the operator-requested renew and surfaces `renewing`. The edge's autocert manager performs the actual renewal ahead of expiry.

### Authentication

`widgetJWT`, `apiKey`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | yes |  |

### Responses

| Status | Description |
| --- | --- |
| `202` | Renewal requested |
| `401` | Error envelope: {code, title, details}. |
| `404` | Error envelope: {code, title, details}. |
| `503` | Error envelope: {code, title, details}. |

### `202` response body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `certificate` | object | no |  |

The full specification is served at `GET https://api.customdomain.ai/v1/openapi.json`.