---
title: creative webhooks
description: Get and rotate the signing secret that verifies generation webhooks.
canonical_url: https://orchestor.io/docs/en/cli/creative/webhooks
markdown_url: https://orchestor.io/docs/en/cli/creative/webhooks.md
contentType: reference
---

# creative webhooks

`orc creative webhooks` manages the signing secret for the completion notifications sent to `--webhook-url`. Your receiver verifies each signature with this secret to confirm the notification came from Orchestor.

After a rotation, new notifications are signed with the new secret. See [Webhooks](https://orchestor.io/docs/creative/webhooks.md) for verification.

## Usage

```bash title="terminal"
orc creative webhooks signing-secret get --json
```

*Get the current signing secret.*

## Subcommands

### `signing-secret get`

Webhook 署名シークレットを取得

```bash title="terminal"
orc creative webhooks signing-secret get [options]
```

### `signing-secret rotate`

Webhook 署名シークレットをローテーション

```bash title="terminal"
orc creative webhooks signing-secret rotate [options]
```

## Examples

### Rotate the signing secret.

```bash title="terminal"
orc creative webhooks signing-secret rotate --json
```

*Rotate the signing secret.*

## Permissions

Requires CLI authentication (`orc auth login` or `ORCHESTOR_API_KEY`) and access to the target Workspace. Rotating the secret requires write access.

## Global Options

The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc creative webhooks`:

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#help)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#output-format)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#raw-output)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#file-output)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#pager)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#dry-run)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#confirmation)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#all-pages)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#request-timing)
- [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#read-only-mode)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#untrusted-content-wrapping)

For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md).

---

[Documentation index](https://orchestor.io/docs/llms.txt)
