Replace a certificate with a renewed one. Services using it switch over in place, without a redeploy.
API key access: full.
apiKeyAuthorizationBearer <pyo_…>An API key from the dashboard's API keys page: Authorization: Bearer pyo_…. Keys can expire, and an expired one gets a 401.
application/jsonReplace a certificate with a renewed one. Services using it switch over in place, without a redeploy.
API key access: full.
op*"replaceCertificate""replaceCertificate"id*stringcertificate*stringprivateKey*stringDone. Always ok: true, and some operations add more, such as a new API key or a join command. A warning comes with a change that went through but won't fully take effect yet, such as more replicas than the servers have room for.
application/jsoncurl -X POST 'https://your-pyo.example.com/api/v1/ops' \
-H 'Content-Type: application/json' \
-d '{
"certificate": "-----BEGIN CERTIFICATE-----\n…\n-----END CERTIFICATE-----",
"id": "crt_8kq2x7ad",
"op": "replaceCertificate",
"privateKey": "-----BEGIN PRIVATE KEY-----\n…\n-----END PRIVATE KEY-----"
}'{}