FruxonDocs
Agent NetworkTriggers

Partial update

Applies a partial update: only the non-null fields of the request are written. `Kind` is immutable. Agent bindings are managed through the nested `bindings` sub-resource, not this endpoint.

PATCH
/v1/tenants/{tenant}/triggers/{trigger}

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

trigger*string

The trigger identifier.

Formatuuid
tenant*string

The tenant identifier

Request Body

The patch payload — null fields are left unchanged.

integrationConfigId?string|null

Repoint the trigger at a different TenantIntegrationConfig (one Slack workspace to another). The integration id itself is immutable — switching providers is a recreate, not an update. Null means "leave alone" (consistent with the rest of this DTO); clearing the pin isn't supported here.

Formatuuid
displayName?string|null
active?boolean|null
timeout?integer|null
Formatint32
Range60 <= value <= 2147483647
scheduleFrequency?string

Frequency of a schedule trigger. Wire form is UPPER_SNAKE per project convention; Unspecified = 0 is the AIP-126 zero-sentinel.

Value in"UNSPECIFIED" | "DAILY" | "WEEKLY" | "MONTHLY" | "INTERVAL"
scheduleDay?string

A day of the week, Sunday through Saturday.

Value in"sunday" | "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday"
scheduleDayOfMonth?string

Enum representing days of the month. Values are 1 to 31 and "Last".

Value in"_1" | "_2" | "_3" | "_4" | "_5" | "_6" | "_7" | "_8" | "_9" | "_10" | "_11" | "_12" | "_13" | "_14" | "_15" | "_16" | "_17" | "_18" | "_19" | "_20" | "_21" | "_22" | "_23" | "_24" | "_25" | "_26" | "_27" | "_28" | "_29" | "_30" | "_31" | "last"
scheduleHour?string|null
scheduleMinute?string|null
intervalValue?integer|null
Formatint32
intervalUnit?string

Unit for the spacing of a recurring Fruxon.Model.Jobs.ScheduleFrequency.Interval job. Wire form is UPPER_SNAKE per project convention; Unspecified = 0 is the AIP-126 zero-sentinel.

Value in"UNSPECIFIED" | "MINUTES" | "HOURS" | "DAYS"
timezone?string|null
filter?

Operator-defined content predicate on an Fruxon.Model.Triggers.TriggerKind.IntegrationEvent trigger. The structural match (integration / config / event type) decides whether an inbound event reaches a trigger at all; the filter decides whether a matched event actually fires the bound agents. A null filter — or one with no conditions — fires always, so every pre-existing trigger is unaffected. Evaluated by Fruxon.Model.Triggers.TriggerEventFilterEvaluator against the inbound payload.* envelope, once per trigger, before the binding fan-out (see Fruxon.Model.Triggers.IntegrationEventDispatcher). Stored as JSONB on the trigger and snapshotted into Fruxon.Model.Triggers.TriggerRevision.

bindings?|null

When non-null, fully replaces the trigger's bindings + mappings: agents in the list are kept or added; bindings missing from the list are removed; for agents that appear in both before and after, the mapping list is replaced wholesale. Null leaves bindings + mappings untouched, consistent with the rest of this patch DTO. The existing per-binding endpoints (PUT/DELETE /triggers/{id}/bindings/{agent}) stay available for atomic single-binding membership tweaks without touching mappings.

[key: string]?never

Response Body

curl -X PATCH "https://api.fruxon.com/v1/tenants/string/triggers/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "00000000-0000-0000-0000-000000000000",
  "kind": "SCHEDULE",
  "integrationId": "string",
  "integrationConfigId": "00000000-0000-0000-0000-000000000000",
  "eventType": "string",
  "displayName": "string",
  "active": false,
  "timeout": 0,
  "scheduleFrequency": "DAILY",
  "scheduleDay": "sunday",
  "scheduleDayOfMonth": "_1",
  "scheduleHour": "string",
  "scheduleMinute": "string",
  "intervalValue": 0,
  "intervalUnit": "MINUTES",
  "timezone": "string",
  "filter": {
    "match": "ALL",
    "conditions": [
      {
        "path": "string",
        "operator": "UNSPECIFIED",
        "value": "string",
        "values": null,
        "caseSensitive": false
      }
    ]
  },
  "createdAt": 0,
  "modifiedAt": 0,
  "lastFiredAt": 0,
  "hasWebhookKey": false,
  "webhookOwnership": "PER_BINDING",
  "agentIds": [
    "string"
  ],
  "bindings": [
    {
      "agentId": "string",
      "parameterMappings": [],
      "outputBindingId": "00000000-0000-0000-0000-000000000000",
      "outputDestination": {
        "bindingId": "00000000-0000-0000-0000-000000000000",
        "participantId": "00000000-0000-0000-0000-000000000000",
        "integrationConfigId": "00000000-0000-0000-0000-000000000000",
        "provider": "string",
        "address": "string"
      },
      "defaultOutputDestinations": []
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Returns a single trigger with its current agent bindings.

Fetches one trigger by id, including the set of agents it currently fires. Returns 404 when no trigger with that id exists in the tenant.

Creates a new trigger and optionally binds it to a set of agents atomically.

Creates the trigger together with any initial agent bindings supplied in the request, in a single transaction. The trigger `Kind` (schedule, webhook, or integration event) is fixed at creation — changing it later requires recreating the trigger, since each kind carries its own configuration shape.