cliDeterministic

Rotate webhook secret

Name: Pipeline
Price: 99 USD

pipeline rotate-webhook-secret

Rotate an endpoint signing secret. Returns the new secret once while the previous secret remains valid for 24 hours.

Parameters

workspaceId

string

Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.

endpointIdrequired

string

No description.

Example

CLI commandbash

pipeline rotate-webhook-secret \
  --endpoint-id "00000000-0000-4000-8000-000000000000"

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "endpoint": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "workspaceId": {
          "type": "string",
          "format": "uuid"
        },
        "name": {
          "type": "string"
        },
        "url": {
          "type": "string",
          "format": "uri"
        },
        "eventTypes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "filters": {
          "type": "object"
        },
        "apiVersion": {
          "type": "string"
        },
        "status": {
          "type": "string",
          "enum": [
            "active",
            "paused",
            "auto_paused"
          ]
        },
        "pauseReason": {
          "type": [
            "string",
            "null"
          ]
        },
        "health": {
          "type": "string",
          "enum": [
            "never_delivered",
            "healthy",
            "failing"
          ]
        },
        "destinationAuth": {
          "type": "object",
          "properties": {
            "type": {
              "type": "string"
            },
            "headerName": {
              "type": [
                "string",
                "null"
              ]
            },
            "configured": {
              "type": "boolean"
            }
          },
          "required": [
            "type",
            "headerName",
            "configured"
          ]
        },
        "consecutiveFailures": {
          "type": "number"
        },
        "lastSuccessAt": {
          "type": [
            "string",
            "null"
          ]
        },
        "lastFailureAt": {
          "type": [
            "string",
            "null"
          ]
        },
        "lastError": {
          "type": [
            "string",
            "null"
          ]
        },
        "createdAt": {
          "type": "string"
        },
        "updatedAt": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "workspaceId",
        "name",
        "url",
        "eventTypes",
        "filters",
        "apiVersion",
        "status",
        "pauseReason",
        "health",
        "destinationAuth",
        "consecutiveFailures",
        "lastSuccessAt",
        "lastFailureAt",
        "lastError",
        "createdAt",
        "updatedAt"
      ]
    },
    "signingSecret": {
      "type": "string"
    }
  },
  "required": [
    "endpoint",
    "signingSecret"
  ]
}

Exit codes

1: Invalid input or local configuration.
2: The API or tool returned an error.
3: Authentication failed.
4: A network request failed.