Create a TLS certificate

POST

/certificates

curl --request POST \
  --url https://sylve.lan:8181/api/certificates \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "certificate": "example", "domain": "example", "dynamicDnsEntryId": 1, "name": "example", "privateKey": "example", "staging": true, "type": "imported", "validateDomain": true }'

Create an imported, self-signed, Let’s Encrypt, or Sylve.app Managed TLS certificate

Authorizations

• BearerAuth

Request Body

Certificate settings

Media typeapplication/json

object

certificate

string

domain

string

dynamicDnsEntryId

integer

name

string

privateKey

string

staging

boolean

type

string

Allowed values: imported self-signed lets-encrypt sylve-managed system-default

validateDomain

boolean

Responses

201

Created

Media typeapplication/json

object

data

object

active

boolean

domain

string

dynamicDnsEntryId

integer

fingerprint

string

id

integer

issuanceError

string

issuanceOperation

string

Allowed values: initial renewal

issuanceRetryAt

string

issuanceStatus

string

name

string

notAfter

string

notBefore

string

pending

boolean

ready

boolean

renewable

boolean

staging

boolean

type

string

Allowed values: imported self-signed lets-encrypt sylve-managed system-default

updatedAt

string

error

string

message

string

status

string

Example

{
  "data": {
    "issuanceOperation": "initial",
    "type": "imported"
  }
}

400

Bad Request

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

409

Conflict

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

413

Payload Too Large

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

500

Internal Server Error

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

502

Bad Gateway

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}