Triggers API

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

GET /api/triggers

返回带 optional filters 的 triggers。

Arguments:

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

Payload: 无。

响应：TriggerView[]。

GET /api/triggers/:fullname

返回 trigger。

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname.

Payload: 无。

响应：TriggerDraftView。

PUT /api/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.
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/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/triggers/:fullname

删除 trigger。

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname.

Payload: 无。

响应：OperationResult。

POST /api/triggers/patch

对多个 triggers 执行 bulk patch。

Arguments: 无。

Payload:

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

响应：TriggerBulkPatchResult。

POST /api/triggers/remove

对多个 triggers 执行 bulk remove。

Arguments: 无。

Payload:

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

响应：TriggerBulkRemoveResult。

GET /api/triggers/:fullname/draft

返回 trigger draft view。

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname.

Payload: 无。

响应：TriggerDraftView。

PUT /api/triggers/:fullname/draft

保存 trigger draft。

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname.

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

响应：TriggerDraftView。

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

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

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname.

Payload: same shape as trigger save payload.

响应：TriggerValidationResult。

GET /api/triggers/:fullname/logs

返回 trigger 的聚合 delivery 失败和 source-pressure 事件。

参数：

参数	位置	说明
fullname	Path	Trigger fullname。
limit	Query	可选的最大日志条数。
status	Query	可选的 delivery 状态筛选。
direction	Query	可选的分页方向：before 或 after。
datetime	Query	与 direction 一起使用的 ISO 时间。

Payload: 无。

响应包含 trigger 信息、subscription 统计和规范化日志。

POST /api/triggers/:fullname/reset-test-status

将 trigger 测试状态重置为 not_tested。

参数：path 中的 fullname。

Payload: 无。

响应：TriggerPatchResult。

POST /api/triggers/preview

验证 provider definitions，在给定 input 上运行可选 activation 和 raw/human transforms，并验证结果 output。此操作不会保存 trigger。

Arguments: 无。

Payload:

Field	Required	Description
providers	是	Provider definitions.
activation	否	JavaScript activation condition 或 null。
transform	是	JavaScript transform object.
input	是	Source item/input for preview.
inputs	否	Trigger input values.
providersData	否	供 activation 和 transforms 使用的预计算 provider values。
outputSchema	否	用于验证 preview 结果的 output schema。

响应：TriggerPreviewResult。

POST /api/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/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/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/triggers/hypercore/actions

返回 trigger builder 可用的 HyperCore action 目录。

参数：无。

Payload: 无。

响应包含 actions 数组。

GET /api/triggers/runtime-sources

返回 trigger builder 可用的 runtime data sources。

Arguments: 无。

Payload: 无。

响应：RuntimeSource[]。

GET /api/template-helpers

返回 trigger defaults 和订阅 action 模板可用的公开 Handlebars helper 元数据。无需身份验证。

参数：无。

请求体：无。

响应包含 handlebars.helpers 数组。每个 helper 都有唯一的 name 和 description；块 helper 还包含 block: true，带命名选项的 helper 则包含由 name 和 type 组成的 params 数组。

POST /api/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
solana_event	type, dataSource	programId, event, idl, 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
solana_account	id, type, account	source, idl, programId, accountName, pda
state_window	id, type, dedupeBy, value, keepLast	partitionBy, valueType, aggregate
javascript	id, type, source	variables