Skip to main content
PUT
Set default destination

Authorizations

Authorization
string
header
required

Enter your JWT token

Body

application/json

The url to point the default destination at.

PUT /v1/triggers/destination - the single-destination convenience alias.

url
string | null

An https URL on a publicly routable host.

name
string | null

Name for the destination if this call CREATES it. Ignored when re-pointing an existing default - renaming is not what this endpoint is for. Defaults to "default".

max_consecutive_failures
integer<int32> | null

Response

The destination. A signing secret is included only when this call created it (201); a re-point returns the destination alone (200).

A named HTTP endpoint Engini delivers trigger events to. The signing secret is never included here - it is shown once, when the destination is created or its secret is rotated.

id
integer<int32>
required

The numeric id, which is what POST /v1/triggers's destination_id takes. Routes address destinations by Name; this is here so a caller can bind a trigger to one without a second lookup.

name
string
required

Slug, unique per account among live destinations.

url
string
required
status
enum<string>
required

Whether a destination is currently accepting deliveries. Engini disables one automatically after too many consecutive failures; updating the destination enables it again.

Available options:
active,
auto_disabled
is_default
boolean

True on the one destination that receives events from triggers naming no destination.

consecutive_failures
integer<int32>

Consecutive DEAD-LETTERED events, not failed attempts. Reset to zero by any successful delivery and by re-enabling the destination.

max_consecutive_failures
integer<int32>

How many consecutive dead-letters auto-disable this endpoint.

last_delivery_at
string<date-time> | null
last_failure_at
string<date-time> | null
last_failure
string | null

Why the last delivery failed, sanitised for a tenant to read - a status code and reason, never a stack trace or an internal host.

created_at
string<date-time>
updated_at
string<date-time> | null