Sign inGet Started

Get the webhook client certificate

GET
/v1/workspace/webhook-client-certificate
curl -X GET "https://us1.platform.bird.com/v1/workspace/webhook-client-certificate" \
  -H "Authorization: Bearer $TOKEN"
Antwort200
{
  "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.

Antwort-Payload

state
string
erforderlich

Whether client certificates are off (disabled), checked while the previous behavior stays available (evaluating), or required (enforced).

Possible values: disabled, evaluating, enforced

crl_check
string
erforderlich

How 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

certificate
nullable object
erforderlich

The certificate in use. null until you upload one.

Untergeordnete Attribute anzeigen
signing_request
nullable object
erforderlich

The signing request that waits for a signed certificate. null when none waits.

Untergeordnete Attribute anzeigen
updated_at
nullable string
erforderlich

When the certificate or its state last changed. null until the first change.

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.