Skip to main content
POST
Rotate Signing Secret

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

trigger_id
string<uuid>
required
workspace
string
required

Slug of the workspace the request acts in

Maximum string length: 120
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Response

Successful Response

Response model for trigger data.

agent_id
string<uuid>
required
conditions
Conditions · object
required
consecutive_failures
integer
required
created_at
string<date-time>
required
created_by
string
required
description
string
required
failure_threshold
integer
required
id
string<uuid>
required
is_active
boolean
required
name
string
required
task_parameters
Task Parameters · object
required
trigger_type
string
required
updated_at
string<date-time>
required
allowed_methods
string[] | null
cron_expression
string | null
data_extractor
string | null
event_types
string[]
has_channel_credentials
boolean
default:false
last_execution_at
string<date-time> | null
next_run_time
string<date-time> | null
signature_scheme
WebhookSignatureScheme · object | null

Signing scheme of a generic webhook; null for other types.

signing_secret
string | null

Generated signing secret of a generic webhook. Returned only by the create and rotate calls that generated it; never readable afterwards.

timezone
string | null
validation_rules
Validation Rules · object | null
webhook_config
Webhook Config · object | null
webhook_id
string | null
webhook_signing
enum<string> | null

What protects the public webhook URL. 'signed': requests without a valid signature or token are refused. 'unsigned': this trigger has no secret, so any request starts the agent. 'unsupported': the platform does not verify this provider's requests. Null for non-webhook triggers, or when the stored secret could not be read.

Available options:
signed,
unsigned,
unsupported
webhook_type
string | null
Last modified on October 3, 2026