Reissue TLS certificate | regfish DNS & TLS API

POST

/tls/certificate/{certificate_id}/reissue

TLSCertificatesByID

Authentifizierung

x-api-keyapplication/json

SchnellstartAuthentifizierung Regfish ConsoleAPI-Key im Regfish-Interface anlegen und testen

Parameter

Name

Typ

Format

Pflicht

Description

certificate_id

path

string

—

Pflicht

Public TLS certificate ID

Request Body

application/jsonPflicht

Reissue request payload

tlsCertificateReissueRequest

{
  "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIIC...\n-----END CERTIFICATE REQUEST-----",
  "dcv_method": "dns-cname-token"
}

Felder

Name

Typ

Format

Pflicht

Description

csr

string

—

Pflicht

PEM encoded certificate signing request (CSR).

common_name

string

—

Optional

Fully Qualified Domain Name.

dns_names

array<string>

—

Optional

Optional. If provided, the SAN list must match the current order exactly.

dcv_method

dns-cname-token, email

string

—

Pflicht

—

comments

string

—

Optional

Optional provider comment stored with the reissue request.

validity_days

integer

—

Optional

Optional requested certificate lifetime in days for the replacement certificate. The CA only honors this for eligible multi-year plan orders and never beyond the remaining order contract.

Request-Beispiel

POST

curl --request POST \
  --url 'https://api.regfish.com/tls/certificate/7K9QW3M2ZT8HJ/reissue' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --data '{
  "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIIC...\n-----END CERTIFICATE REQUEST-----",
  "dcv_method": "dns-cname-token"
}'

Responses

200

TLS certificate reissue accepted

application/jsontlsCertificateResponse

Response-Beispiel 200

{
  "success": true,
  "code": 0,
  "response": {
    "id": "7K9QW3M2ZT8HJ",
    "status": "pending",
    "common_name": "example",
    "product": "example",
    "provider": "digicert",
    "dns_names": [
      "example"
    ],
    "action_required": false,
    "pending_reason": "validation_pending",
    "pending_message": "The TLS certificate order is waiting for domain validation.",
    "completion_url": "",
    "organization_id": null,
    "certificate_pem_available": false
  }
}

400

Invalid request payload or CSR

application/jsonError

Response-Beispiel 400

{
  "success": false,
  "message": "Invalid request payload or CSR",
  "error": "Invalid request payload or CSR"
}

401

Unauthorized

application/jsonError

Response-Beispiel 401

{
  "success": false,
  "message": "Unauthorized",
  "error": "Unauthorized"
}

404

TLS certificate not found

application/jsonError

Response-Beispiel 404

{
  "success": false,
  "message": "TLS certificate not found",
  "error": "TLS certificate not found"
}

409

The TLS certificate cannot be reissued in its current state

application/jsonError

Response-Beispiel 409

{
  "success": false,
  "message": "The TLS certificate cannot be reissued in its current state",
  "error": "The TLS certificate cannot be reissued in its current state"
}

500

Unexpected error

application/jsonError

Response-Beispiel 500

{
  "success": false,
  "message": "Unexpected error",
  "error": "Unexpected error"
}

502

Upstream TLS provider error

application/jsonError

Response-Beispiel 502

{
  "success": false,
  "message": "Upstream TLS provider error",
  "error": "Upstream TLS provider error"
}

Verwandte Modelle

baseResult

csr

PEM encoded certificate signing request (CSR).

Error

fqdn

Fully Qualified Domain Name (FQDN, ending with a period).

fqdn_relaxed

Fully Qualified Domain Name.

tlsCertificateDcvMethod

tlsCertificateId

Public TLS certificate ID

tlsCertificateOrderCancellationMode

tlsCertificateOrganization

tlsCertificateProvider

tlsCertificateReissueRequest

tlsCertificateReissueResponse

tlsCertificateReissueStatus

tlsCertificateResponse

tlsCertificateRevocationScope

tlsCertificateStatus

tlsOrganizationId

Public TLS organization ID

tlsOrganizationStatus

tlsValidation

tlsValidationDnsRecord

Authentifizierung

Parameter

Request Body

Felder

Request-Beispiel

Responses

Werde ein Teil der Community