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}
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

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

Day of the week, used by weekly schedules (chat-user tasks, triggers, asset auto-update polls). Matches google.type.DayOfWeek exactly: Unspecified=0, Monday=1..Sunday=7. The wire form is UPPER_SNAKE per AIP-126 and the project's enum convention.

This is a deliberate divergence from System.DayOfWeek (which numbers Sunday=0..Saturday=6 and has no Unspecified sentinel). The BCL enum is the right C# type for "what day is System.DateTime on?", but the wrong type for an externally-visible recurrence field — it can't carry [JsonConverter] at the type level (we don't own mscorlib), so its wire form has to be patched via property-level attributes everywhere, which is exactly the carve-out this enum retires. Use M:Fruxon.Model.Jobs.WeekDayExtensions.ToBclDayOfWeek(Fruxon.Model.Jobs.WeekDay) to convert at the scheduler comparison sites where you need to compare against System.DateTime.DayOfWeek.

Value in"UNSPECIFIED" | "MONDAY" | "TUESDAY" | "WEDNESDAY" | "THURSDAY" | "FRIDAY" | "SATURDAY" | "SUNDAY"
scheduleDayOfMonth?integer|null
Formatint32
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": "MONDAY",
  "scheduleDayOfMonth": 0,
  "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": [],
      "environmentSlug": "string",
      "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": []
    }
  ],
  "pipelineId": "00000000-0000-0000-0000-000000000000"
}
{
  "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
}