Triggers API

Trigger endpoints 用于管理 trigger definitions、drafts、bulk operations 和 test helpers。

GET /api/v2/triggers

返回带 optional filters 的 triggers。

Arguments:

Argument	Location	Description
project	Query	Project fullname filter.
workspace	Query	Workspace fullname filter.

Payload: 无。

响应：TriggerView[]。

GET /api/v2/triggers/:fullname

返回 trigger。

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname.

Payload: 无。

响应：TriggerDraftView。

PUT /api/v2/triggers/:fullname

创建或完整保存 trigger。

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname. 必须与 payload.fullname 一致。

Payload:

Field	Required	Description
name	是	project 内的 Trigger name。
fullname	是	Trigger fullname.
project	是	Project fullname.
workspace	是	Workspace fullname.
backend	是	Backend object。通常是 { type: "sdk", trigger, values }。
inputs	是	Input schema.
meta.title	是	可见标题。
meta.description	否	描述。
defaults	否	Notification defaults.
output	否	Legacy output schema.
triggerSpec	否	Source matching spec 或 null。
providers	否	Array of provider definitions.
filtersSchema	否	Optional filters schema.
outputSchema	否	Human/raw output schema.
transform	否	JavaScript transform 或 null。
activation	否	JavaScript activation condition 或 null。
executionPolicy	否	Runtime limits override object 或 null。
status	否	{ status, issue, source, updatedAt }.
tags	否	Tags.
labels	否	Labels.

响应：TriggerDraftView。

PATCH /api/v2/triggers/:fullname

部分修改 trigger。

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname.

Payload:

Field	Required	Description
set	One of	Object with dotted paths and values to set.
unset	One of	Array of dotted paths to remove.
dryRun	否	If true, validate patch without saving.

响应：TriggerPatchResult。

DELETE /api/v2/triggers/:fullname

删除 trigger。

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname.

Payload: 无。

响应：OperationResult。

POST /api/v2/triggers/patch

对多个 triggers 执行 bulk patch。

Arguments: 无。

Payload:

Field	Required	Description
items	是	Array of { fullname, set?, unset? }.
dryRun	否	Validate without saving.

响应：TriggerBulkPatchResult。

POST /api/v2/triggers/remove

对多个 triggers 执行 bulk remove。

Arguments: 无。

Payload:

Field	Required	Description
fullnames	是	Array of trigger fullnames.
dryRun	否	Validate without deleting.

响应：TriggerBulkRemoveResult。

GET /api/v2/triggers/:fullname/draft

返回 trigger draft view。

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname.

Payload: 无。

响应：TriggerDraftView。

PUT /api/v2/triggers/:fullname/draft

保存 trigger draft。

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname.

Payload: same shape as PUT /api/v2/triggers/:fullname.

响应：TriggerDraftView。

POST /api/v2/triggers/:fullname/draft/validate

验证 trigger draft，但不执行最终保存。

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname.

Payload: same shape as trigger save payload.

响应：TriggerValidationResult。

POST /api/v2/triggers/preview

在不保存 trigger 的情况下 preview transform/providers output。

Arguments: 无。

Payload:

Field	Required	Description
providers	是	Provider definitions.
transform	是	JavaScript transform object.
input	是	Source item/input for preview.
inputs	否	Trigger input values.
outputSchema	否	Output schema used for formatting.

响应：TriggerPreviewResult。

POST /api/v2/triggers/test

在 sample source item 上测试 trigger definition。

Arguments: 无。

Payload:

Field	Required	Description
triggerSpec	是	Source matching spec.
providers	是	Provider definitions.
transform	是	JavaScript transform.
outputSchema	是	Output schema.
activation	否	Activation condition.
inputs	否	Input values.
input	One of	Direct test input.
test	One of	Test source/match object.

响应：TriggerTestResult。

POST /api/v2/triggers/test-block

在指定 block 上测试 trigger。

Arguments: 无。

Payload:

Field	Required	Description
triggerSpec	是	Source matching spec.
providers	是	Provider definitions.
transform	是	JavaScript transform.
outputSchema	是	Output schema.
block	是	Block number.
itemIndex	否	Source item index inside block.
activation	否	Activation condition.
filtersSchema	否	Filters schema.
inputs	否	Input values.

响应：TriggerTestResult。

POST /api/v2/triggers/providers/test

测试一个 provider。

Arguments: 无。

Payload:

Field	Required	Description
triggerSpec	是	Source matching spec.
provider	是	Provider definition.
project	否	Project fullname.
workspace	否	Workspace fullname.
templateValues	否	Template values for provider placeholders.

响应：ProviderTestResult。

GET /api/v2/triggers/runtime-sources

返回 trigger builder 可用的 runtime data sources。

Arguments: 无。

Payload: 无。

响应：RuntimeSource[]。

POST /api/v2/triggers/find-latest-block

为 trigger testing 查找 latest block/test input。

Arguments: 无。

Payload: trigger/source-specific search object.

响应：LatestBlockResult。

Trigger Spec

triggerSpec describes source matching.

Supported variants:

Type	Required fields	Optional fields
evm_log	type, dataSource	contract, event, abiFragment, topicsCount, dataBytes, testInput
evm_transaction	type, dataSource	testInput
substrate_event	type, dataSource	pallet, event, testInput
timer	type, interval	testInput

Provider Definition

Each provider has id, type, optional weight, optional timeoutMs, and optional outputSchema.

Supported provider types:

Type	Required fields	Main optional fields
http	id, type, url	method, headers, queryParams, body
graphql	id, type, url, query	headers, variables
rpc with transport: "endpoint"	id, type, url, method	headers, params, body
rpc with transport: "source"	id, type, transport, method	params
substrate_storage	id, type, module, entry	source, args, block
evm_read	id, type, contract, method, abiFragment	source, abiContract, args
state_window	id, type, dedupeBy, value, keepLast	partitionBy, valueType, aggregate
javascript	id, type, source	variables