Renew a certificate

/api/v1/companies/{company}/certificates/{certificate}/renew

Company-admin. Certificate must not be revoked and must not already have a pending request (409 CERTIFICATE_REVOKED / REQUEST_ALREADY_PENDING).

Path parameters

Field	Type	Description
company Required	string	Path parameter `company`.
certificate Required	string	Path parameter `certificate`.

Query parameters

This endpoint has no query parameters.

Request body

Field	Type	Description
uid Required	string	Certificate UID / enrollment identifier. e.g. "user.jane"
common_name Required	string	X.509 common name. e.g. "Jane Doe"
country Required	string	ISO 3166-1 alpha-2 country. e.g. "CI"
enrollment_username Required	string	Enrollment username issued with the certificate. e.g. "jane.doe"
enrollment_code Required	string	Enrollment code issued with the certificate. e.g. "ENROLL-EXAMPLE-CODE"
key_algorithm	string	`RSA_2048` or `RSA_4096`. e.g. "RSA_2048"
email_address	string	Email embedded in the certificate. e.g. "jane@acme.test"
title	string	Job title. e.g. "CFO"
organizational_unit	string	Organizational unit. e.g. "Finance"
organization	string	Organization. e.g. "ACME"
state	string	State or region. e.g. "Abidjan"
telephone_number	string	Telephone number. e.g. "+2250700000001"
validity_days	integer	Validity in days (1–3650). e.g. 365

Responses

Status	Meaning
200	Renewal requested
401	Missing or invalid Bearer token.

curl -X POST 'https://api.dkbsigns.com/api/v1/companies/company/certificates/certificate/renew' \ -H 'Authorization: Bearer $DKBSIGN_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"uid":"user.jane","common_name":"Jane Doe","country":"CI","enrollment_username":"jane.doe","enrollment_code":"ENROLL-EXAMPLE-CODE","key_algorithm":"RSA_2048","email_address":"jane@acme.test","title":"CFO","organizational_unit":"Finance","organization":"ACME","state":"Abidjan","telephone_number":"+2250700000001","validity_days":365}'

Renew a certificate

Path parameters

Query parameters

Request body

Responses

Request

Response 200