POST | Sign request

  • 1 minute(s) read
Prev Next

Signs an existing certificate request.

  • Endpoint: /api/certificate/request/sign/{request_id}
  • Method: POST
  • Request: POST /api/certificate/request/sign/{request_id}

Path parameters

Parameter Type Required Description
request_id int Yes Certificate request ID to be signed.

Request parameters

Parameter Type Required Description
self_signed int Yes Indicates if it's self-signed. The options are: 1 = true and 0 = false.
ca int Conditional The CA code is responsible for request signing. This code is necessary if self\_signed is set to false.
justification string No Justification text (max. 1024 characters).
reason int Yes Reason code for signing. There must be a valid reason code in Segura®.
itsm_code string Conditional ITSM code. Required if the Governance code required when justifying field is enabled in the certificate access group.

Example using cURL

curl -X POST https://[segura_vault_url]/api/certificate/request/sign/123 \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "self_signed": 0,
    "ca": 5,
    "justification": "Annual certificate renewal",
    "reason": 3,
    "itsm_code": "CHG0012345"
  }'

Response

{
  "status": 200,
  "message": "Request signed successfully",
  "error": false,
  "code_request": 123,
  "self_signed": 0,
  "ca": "5 - GlobalSign",
  "justification": "Annual certificate renewal",
  "reason": "3 - Scheduled Renewal",
  "itsm_code": "CHG0012345"
}

Error responses

HTTP Status Code Description
400 Bad Request Invalid parameters provided.
401 Unauthorized Unauthorized access.
403 Forbidden Forbidden access.
404 Not Found Resource not found.
500 Internal Server Error Internal server error.