curl -X POST \
-H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/projects/{projectId}/webhooks/connections/{id}/secret/rotate"{
"created_at": "2023-11-07T05:31:56Z",
"id": "<string>",
"project_id": "<string>",
"secret": "<string>",
"secret_prefix": "<string>",
"surface": "PLATFORM",
"url": "<string>",
"created_by": {
"id": "<string>",
"name": "<string>"
},
"name": "<string>",
"revoked_at": "2023-11-07T05:31:56Z"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Rotate a webhook connection's signing secret
Generates a new signing secret for the connection and returns it once. The previous secret stops validating immediately, so update the receiver before rotating in production. Send an Idempotency-Key to retry safely: a retry under the same key returns the same new secret instead of rotating again.
curl -X POST \
-H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/projects/{projectId}/webhooks/connections/{id}/secret/rotate"{
"created_at": "2023-11-07T05:31:56Z",
"id": "<string>",
"project_id": "<string>",
"secret": "<string>",
"secret_prefix": "<string>",
"surface": "PLATFORM",
"url": "<string>",
"created_by": {
"id": "<string>",
"name": "<string>"
},
"name": "<string>",
"revoked_at": "2023-11-07T05:31:56Z"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Authorizations
Headers
A key you choose, such as a UUID, to retry this request safely. Resend the same key with the same request and the first response is returned with Idempotent-Replayed: true instead of the request running again, for 24 hours after it succeeded. The same key with a different request returns 422 idempotency_key_reused; a retry while the first request is still running returns 409 idempotency_key_in_use. A request that fails does not use up its key.
8 - 128Path Parameters
Response
OK
Which Particle surface created this connection. Fixed at create time and inferred from the caller's authenticated surface context. Provenance only — an alert on either surface can deliver through it. Render it to show where the endpoint was registered.
PLATFORM, RADAR Was this page helpful?