nsindocs Search the docs⌘K
API
  1. Docs
  2. API reference
  3. SSL

Remove an uploaded certificate

deletehttps://api.nsin.ir/domains/{domain}/ssl/certificates/{certificateId}

Auth: Authorization: Bearer nsin_… or X-Api-Key: nsin_… — see API keys.

Forgets a certificate you uploaded. Any hostname serving it falls back to the certificate NSIN manages.

Only uploads can be removed — a certificate NSIN issues is replaced by its own renewal, so select a different one instead. The request is refused when a hostname serving it has nothing to fall back on, rather than taking that hostname off HTTPS. Requires ssl.manage.

Path parameters

  • domainstringrequiredpath

    The domain name (for example example.com) — not a numeric id.

  • certificateIdintegerrequiredpath

    The id of a certificate from GET /domains/{domain}/ssl/certificates.

Responses

200Removed. hostnames lists the names that fell back.

Content type: application/json

  • messagestring
  • hostnamesarray of string
json
{
  "message": "string",
  "hostnames": [
    "string"
  ]
}
400The certificate is managed by NSIN, or removing it would leave a hostname with nothing to serve.

Content type: application/json

  • errorstringrequired

    Human-readable description of what went wrong.

json
{
  "error": "read-only API key"
}
401Missing, malformed, revoked or expired API key. (A valid key whose account has been deactivated gets 403 account is inactive instead.)

Content type: application/json

  • errorstringrequired

    Human-readable description of what went wrong.

json
{
  "error": "invalid API key"
}
403The key is read-only, your role on the domain lacks the required permission, or the domain's plan does not include the feature.

Content type: application/json

  • errorstringrequired

    Human-readable description of what went wrong.

json
{
  "error": "read-only API key"
}
404No such certificate for this domain.

Content type: application/json

  • errorstringrequired

    Human-readable description of what went wrong.

json
{
  "error": "read-only API key"
}
429The key exceeded its request budget (300 requests per minute by default).

Content type: application/json

  • errorstringrequired

    Human-readable description of what went wrong.

json
{
  "error": "rate limit exceeded"
}

Example request

bash
curl -X DELETE "https://api.nsin.ir/domains/example.com/ssl/certificates/0" \
  -H "Authorization: Bearer $NSIN_API_KEY"
esc