Certificate Authorities

Create Certificate Authority

Upload a new Certificate Authority

Request

POST /certificate_authorities

Example Request

Loading…

Parameters

Name	Type	Description
description	string	human-readable description of this Certificate Authority. optional, max 255 bytes.
metadata	string	arbitrary user-defined machine-readable data of this Certificate Authority. optional, max 4096 bytes.
ca_pem	string	raw PEM of the Certificate Authority

Response

Returns a 201 response on success

Example Response

Loading…

Fields

Name	Type	Description
id	string	unique identifier for this Certificate Authority
uri	string	URI of the Certificate Authority API resource
created_at	string	timestamp when the Certificate Authority was created, RFC 3339 format
description	string	human-readable description of this Certificate Authority. optional, max 255 bytes.
metadata	string	arbitrary user-defined machine-readable data of this Certificate Authority. optional, max 4096 bytes.
ca_pem	string	raw PEM of the Certificate Authority
subject_common_name	string	subject common name of the Certificate Authority
not_before	string	timestamp when this Certificate Authority becomes valid, RFC 3339 format
not_after	string	timestamp when this Certificate Authority becomes invalid, RFC 3339 format
key_usages	List<string>	set of actions the private key of this Certificate Authority can be used for
extended_key_usages	List<string>	extended set of actions the private key of this Certificate Authority can be used for

Delete Certificate Authority

Delete a Certificate Authority

Request

DELETE /certificate_authorities/{id}

Example Request

Loading…

Response

Returns a 204 response with no body on success

Get Certificate Authority

Get detailed information about a certficate authority

Request

GET /certificate_authorities/{id}

Example Request

Loading…

Response

Returns a 200 response on success

Example Response

Loading…

Fields

Name	Type	Description
id	string	unique identifier for this Certificate Authority
uri	string	URI of the Certificate Authority API resource
created_at	string	timestamp when the Certificate Authority was created, RFC 3339 format
description	string	human-readable description of this Certificate Authority. optional, max 255 bytes.
metadata	string	arbitrary user-defined machine-readable data of this Certificate Authority. optional, max 4096 bytes.
ca_pem	string	raw PEM of the Certificate Authority
subject_common_name	string	subject common name of the Certificate Authority
not_before	string	timestamp when this Certificate Authority becomes valid, RFC 3339 format
not_after	string	timestamp when this Certificate Authority becomes invalid, RFC 3339 format
key_usages	List<string>	set of actions the private key of this Certificate Authority can be used for
extended_key_usages	List<string>	extended set of actions the private key of this Certificate Authority can be used for

List Certificate Authorities

List all Certificate Authority on this account

Request

GET /certificate_authorities

Example Request

Loading…

Response

Returns a 200 response on success

Example Response

Loading…

Fields

Name	Type	Description
certificate_authorities	CertificateAuthority	the list of all certificate authorities on this account
uri	string	URI of the certificates authorities list API resource
next_page_uri	string	URI of the next page, or null if there is no next page

CertificateAuthority fields

Name	Type	Description
id	string	unique identifier for this Certificate Authority
uri	string	URI of the Certificate Authority API resource
created_at	string	timestamp when the Certificate Authority was created, RFC 3339 format
description	string	human-readable description of this Certificate Authority. optional, max 255 bytes.
metadata	string	arbitrary user-defined machine-readable data of this Certificate Authority. optional, max 4096 bytes.
ca_pem	string	raw PEM of the Certificate Authority
subject_common_name	string	subject common name of the Certificate Authority
not_before	string	timestamp when this Certificate Authority becomes valid, RFC 3339 format
not_after	string	timestamp when this Certificate Authority becomes invalid, RFC 3339 format
key_usages	List<string>	set of actions the private key of this Certificate Authority can be used for
extended_key_usages	List<string>	extended set of actions the private key of this Certificate Authority can be used for

Update Certificate Authority

Update attributes of a Certificate Authority by ID

Request

PATCH /certificate_authorities/{id}

Example Request

Loading…

Parameters

Name	Type	Description
id	string
description	string	human-readable description of this Certificate Authority. optional, max 255 bytes.
metadata	string	arbitrary user-defined machine-readable data of this Certificate Authority. optional, max 4096 bytes.

Response

Returns a 200 response on success

Example Response

Loading…

Fields

Name	Type	Description
id	string	unique identifier for this Certificate Authority
uri	string	URI of the Certificate Authority API resource
created_at	string	timestamp when the Certificate Authority was created, RFC 3339 format
description	string	human-readable description of this Certificate Authority. optional, max 255 bytes.
metadata	string	arbitrary user-defined machine-readable data of this Certificate Authority. optional, max 4096 bytes.
ca_pem	string	raw PEM of the Certificate Authority
subject_common_name	string	subject common name of the Certificate Authority
not_before	string	timestamp when this Certificate Authority becomes valid, RFC 3339 format
not_after	string	timestamp when this Certificate Authority becomes invalid, RFC 3339 format
key_usages	List<string>	set of actions the private key of this Certificate Authority can be used for
extended_key_usages	List<string>	extended set of actions the private key of this Certificate Authority can be used for