Reference
1 min read
get/v7/certs/{id}

Get cert by id

Optional params

fetch-request

1
await fetch("https://api.vercel.com/v7/certs/SOME_STRING_VALUE?slug=SOME_STRING_VALUE&teamId=SOME_STRING_VALUE", {
2
"headers": {
3
"Authorization": "Bearer <TOKEN>"
4
},
5
"method": "get"
6
})
Path Params
Query Params
Path ParameterDescription

id

string

required
The cert id
  • autoRenewbooleanRequired
  • cnsarrayRequired
  • createdAtnumberRequired
  • expiresAtnumberRequired
  • idstringRequired
CodeDescription
200
400One of the provided values in the request query is invalid.
401
403You do not have permission to access this resource.
404
post/v7/certs

Issue a new cert

Optional params

fetch-request

1
await fetch("https://api.vercel.com/v7/certs?slug=SOME_STRING_VALUE&teamId=SOME_STRING_VALUE", {
2
"body": {
3
"cns": "SOME_ARRAY OF STRING_VALUE"
4
},
5
"headers": {
6
"Authorization": "Bearer <TOKEN>"
7
},
8
"method": "post"
9
})
Query Params
Body Params
Query ParameterDescription

slug

string

The Team slug to perform the request on behalf of.

teamId

string

The Team identifier to perform the request on behalf of.
  • autoRenewbooleanRequired
  • cnsarrayRequired
  • createdAtnumberRequired
  • expiresAtnumberRequired
  • idstringRequired
CodeDescription
200
400One of the provided values in the request body is invalid.
401
402
  • The account was soft-blocked for an unhandled reason.

  • The account is missing a payment so payment method must be updated

403You do not have permission to access this resource.
404
449
500
delete/v7/certs/{id}

Remove cert

Optional params

fetch-request

1
await fetch("https://api.vercel.com/v7/certs/SOME_STRING_VALUE?slug=SOME_STRING_VALUE&teamId=SOME_STRING_VALUE", {
2
"headers": {
3
"Authorization": "Bearer <TOKEN>"
4
},
5
"method": "delete"
6
})
Path Params
Query Params
Path ParameterDescription

id

string

required
The cert id to remove
  • object
CodeDescription
200
400One of the provided values in the request query is invalid.
401
403You do not have permission to access this resource.
404
put/v7/certs

Upload a cert

Optional params

fetch-request

1
await fetch("https://api.vercel.com/v7/certs?slug=SOME_STRING_VALUE&teamId=SOME_STRING_VALUE", {
2
"body": {
3
"ca": "SOME_STRING_VALUE",
4
"cert": "SOME_STRING_VALUE",
5
"key": "SOME_STRING_VALUE",
6
"skipValidation": true
7
},
8
"headers": {
9
"Authorization": "Bearer <TOKEN>"
10
},
11
"method": "put"
12
})
Query Params
Body Params
Query ParameterDescription

slug

string

The Team slug to perform the request on behalf of.

teamId

string

The Team identifier to perform the request on behalf of.
  • autoRenewbooleanRequired
  • cnsarrayRequired
  • createdAtnumberRequired
  • expiresAtnumberRequired
  • idstringRequired
CodeDescription
200
400One of the provided values in the request body is invalid.
401
402This feature is only available for Enterprise customers.
403You do not have permission to access this resource.
Last updated on April 27, 2024