Update order contacts
2 minute read
PUT
Use this endpoint to update the order-level organization and technical contact for the given certificate order.https://www.digicert.com/services/v2/order/certificate/{{order_id}}/contact
This endpoint supports the following operations:
- Add an order-level technical contact.
- Replace or modify the existing order-level technical contact.
- Replace or modify the existing order-level organization contact.
Usage and limitations
- This endpoint can only add, replace, and modify contacts. The Services API does not support removing organization or technical contacts from an order.
- An order can have only one organization contact and one technical contact. In your request body, the
contactsarray can include only one contact of eachcontact_type. - DV TLS/SSL orders cannot have order-level organization contacts. If you provide an organization contact in your request to edit contacts on a DV TLS order, the API returns an error.
- DigiCert does not update contact types omitted from your request. For example, if your request includes a single contact object with a
contact_typeoforganization_contact, we only update the organization contact for the order. The technical contact for the order remains unchanged. - Omitting optional fields from a
contactobject leaves existing values for those fields unchanged.
Example requests and responses
Update contacts (cURL)
curl --request PUT 'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/contact' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"contacts": [
{
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com",
"job_title": "SRE",
"telephone": "1234567890",
"language_id": "1",
"contact_type": "organization_contact"
},
{
"first_name": "Jane",
"last_name": "Doe",
"email": "jane.doe@example.com",
"job_title": "SRE",
"telephone": "1234567890",
"language_id": "1",
"contact_type": "technical_contact"
}
]
}'
204 No Content
// No content
Path parameters
| Name | Req/Opt | Type | Description |
|---|---|---|---|
| order_id | required | string | Order ID. |
Request parameters
| Name | Req/Opt | Type | Description |
|---|---|---|---|
| contacts | required | array of objects | List of order-level contacts. Must include at least one contact object. Limited to one contact of each contact_type. |
| .. contact_type | required | string | Contact type. Allowed values: technical_contact, organization_contact |
| .. first_name | required | string | Contact first name. Character limit: 128 |
| .. last_name | required | string | Contact last name. Character limit: 128 |
| required | string | Contact email address. Character limit: 255 | |
| .. job_title | optional | string | Contact job title. Character limit: 64 |
| .. telephone | optional | string | Contact telephone number. Character limit: 32 |
| .. language_id | optional | string | Contact language ID. Possible values: See Glossary – Locale codes. |
Was this page helpful?
Provide feedback