Get the webhook client certificate
/v1/workspace/webhook-client-certificatecurl -X GET "https://us1.platform.bird.com/v1/workspace/webhook-client-certificate" \
-H "Authorization: Bearer $TOKEN"{
"state": "disabled",
"crl_check": "disabled",
"certificate": {
"subject": "CN=bird-webhooks,O=Example Inc.",
"issuer": "CN=Example Client CA,O=Example Inc.",
"serial_number": "4f2a91c0d3",
"fingerprint_sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
},
"signing_request": {
"csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIIB...\n-----END CERTIFICATE REQUEST-----\n"
}
}
Returns the client certificate that we present on webhook deliveries of your workspace, its state and any waiting signing request. Realtime delivers realtime.* events without the certificate. Connector endpoints and MCP Events subscriptions never present it.
响应载荷
stateWhether client certificates are off (disabled), checked while the previous behavior stays available (evaluating), or required (enforced).
Possible values: disabled, evaluating, enforced
crl_checkHow a certificate chain is checked against the certificate revocation list (CRL) that each certificate names. With full_chain, the leaf certificate and each intermediate certificate below the trusted root are checked. A certificate that names no CRL is not checked.
Possible values: disabled, full_chain
certificateThe certificate in use. null until you upload one.
显示子属性
certificate.subjectThe distinguished name of the certificate.
certificate.issuerThe distinguished name of the certificate authority that signed it.
certificate.serial_numberThe serial number, in lowercase hexadecimal.
certificate.fingerprint_sha256The SHA-256 fingerprint of the certificate, in lowercase hexadecimal.
certificate.not_beforeStart of the validity period.
certificate.not_afterEnd of the validity period.
signing_requestThe signing request that waits for a signed certificate. null when none waits.
updated_atWhen the certificate or its state last changed. null until the first change.