# Submit server certificate renewal request (https://developer.godaddy.com/en/docs/references/rest/ans/submit-server-certificate-renewal)

---
title: Submit server certificate renewal request
description: Initiates server certificate renewal.
full: true
---

Full description

Initiates server certificate renewal. Returns ACME challenges that the caller must verify using POST verify-acme. Supports a CSR path (RA issues the certificate) and a BYOC path (caller provides the certificate). Only one pending renewal is allowed per agent; 409 if one already exists.

## POST /v1/agents/{agentId}/certificates/server/renewal

Submit server certificate renewal request

Initiates server certificate renewal. Returns ACME challenges that the caller must verify using POST verify-acme. Supports a CSR path (RA issues the certificate) and a BYOC path (caller provides the certificate). Only one pending renewal is allowed per agent; 409 if one already exists.

### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `agentId` | string | yes | Unique identifier of the agent (UUID format) |

### Request body (required)

Renewal request (CSR or BYOC)

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ServerCertificateRenewal`

### Responses

**202** — Renewal request accepted. Returns ACME challenges for domain validation; the caller must complete verification using POST verify-acme. For the CSR path, the response also includes a csrId for tracking.

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/RenewalSubmission`

**401** — Authentication failed

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**403** — Authorization failed

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**404** — Agent not found

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**409** — Pending renewal already exists for this agent

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**422** — Validation failed:
- Agent not ACTIVE
- Neither serverCsrPEM nor serverCertificatePEM provided
- Both serverCsrPEM and serverCertificatePEM provided
- CSR validation failed (SAN/CN mismatch)
- BYOC cert validation failed (expired, SAN/CN mismatch)
- serverCertificateChainPEM provided without serverCertificatePEM

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**500** — Internal server error

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`