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.
Authorization
Bearer JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.
In: header
Path Parameters
The trigger identifier.
uuidThe tenant identifier
Response Body
curl -X GET "https://api.fruxon.com/v1/tenants/string/triggers/497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"id": "00000000-0000-0000-0000-000000000000",
"networkId": "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",
"scheduleDays": [
"MONDAY"
],
"scheduleDayOfMonth": 0,
"scheduleHour": "string",
"scheduleMinute": "string",
"scheduleTimes": [
{
"hour": 0,
"minute": 0
}
],
"intervalValue": 0,
"intervalUnit": "MINUTES",
"timezone": "string",
"filter": {
"match": "ALL",
"conditions": [
{
"path": "string",
"operator": "UNSPECIFIED",
"value": "string",
"values": null,
"caseSensitive": false
}
]
},
"workShape": {
"door": {
"doorId": "string",
"integrationConfigId": "string",
"query": "string",
"parameters": {},
"startFrom": 0,
"skipWhen": {
"match": "UNSPECIFIED",
"conditions": []
},
"projection": [
"string"
]
},
"source": {
"kind": "TOOL",
"ragAssetId": "string",
"ragReadMode": "DOCUMENTS",
"ragSearch": "string",
"pageSize": 0,
"integrationConfigId": "string",
"integrationId": "string",
"listToolId": "string",
"getToolId": "string",
"recordsPath": "string",
"cursorParamName": "string",
"totalPath": "string",
"pageOrder": "SOURCE_ORDER",
"parameters": {},
"itemIdPath": "string",
"itemVersionPath": "string",
"previousVersionField": "string",
"sinkTargetPath": "string",
"sinkTargetKind": "ROW",
"skipWhen": {
"match": "UNSPECIFIED",
"conditions": []
},
"sourceUrlPath": "string",
"cursorPath": "string",
"watermarkParamName": "string",
"watermarkFormat": "RAW",
"overlapWindowMs": 0,
"startFrom": 0,
"flattenSheetRows": false
},
"onDemand": {
"keyPaths": [
"string"
],
"labelPaths": [
"string"
],
"inputs": [],
"tool": {
"enabled": false,
"description": "string"
},
"agentsMayStart": false
},
"stages": [
{
"id": "string",
"displayName": "string",
"kind": "UNSPECIFIED",
"agentId": "string",
"instruction": "string",
"ask": null,
"wait": null,
"batch": null,
"sink": null,
"actionTypeCeiling": null,
"claimLimit": null,
"maxRunning": null,
"parameters": [],
"produces": [],
"requires": [],
"dedupeKey": [],
"routes": [],
"ignoreReasons": []
}
],
"parameters": [
{
"name": "string",
"value": "string",
"description": "string"
}
],
"policy": {
"claimLimit": 0,
"maxAttempts": 0,
"leaseSeconds": 0,
"actionTypeCeiling": "READ_ONLY",
"itemCostCapUsd": 0,
"effectiveClaimLimit": 1,
"effectiveMaxAttempts": 1,
"effectiveLeaseSeconds": 1
},
"outcomeUnit": {
"singular": "string",
"plural": "string"
},
"cohorts": {
"window": "DAY",
"settleWithinHours": 0,
"confirmAboveCredits": 0,
"followUp": []
}
},
"outcomeDigest": {
"frequency": "DAILY",
"sendHour": 0,
"report": {
"agentId": "string",
"contactSlot": "string",
"labelPaths": [
"string"
],
"isComplete": true,
"effectiveLabelPaths": [
"string"
]
}
},
"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": []
}
],
"warnings": [
"string"
],
"managedBy": {
"ownerKind": "KNOWLEDGE_SOURCE",
"ownerId": "00000000-0000-0000-0000-000000000000",
"roles": [
"SOURCE"
],
"ownership": "MANAGED",
"ownerDisplayName": "string",
"ownerContainerId": "00000000-0000-0000-0000-000000000000",
"ownerContainerDisplayName": "string",
"linkedOwnerCount": 0
}
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}Fires the trigger immediately against every bound agent's current revision.
Fires bound agents using their current revisions. This is a real execution: tools may send messages or modify external systems. Returns 404 for an unknown trigger. samplePayload simulates an inbound payload for INTEGRATION_EVENT triggers; SCHEDULE triggers reject it with 400. A scheduled agent still running its previous execution returns 409; resolve or cancel it before firing again. Work-shape automations run a sweep instead: maxAdmit bounds new admissions (zero admits none), maxDispatch bounds item claims, stageIds restricts stages and closeGathering closes collecting batches. These bounds apply only to this invocation and do not alter the schedule. Unknown stages return 400.
Lists what the automation is waiting on a human for.
Each batch is one shared question with a set of items waiting on its answer. It is the operator's awaiting-human entry, and its waiting count is the number an operator reads.