Triggers API

Trigger endpoints gerem trigger definitions, drafts, bulk operations e test helpers.

GET /api/v2/triggers

Devolve triggers com optional filters.

Arguments:

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

Payload: nenhum.

Resposta: TriggerView[].

GET /api/v2/triggers/:fullname

Devolve trigger.

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname.

Payload: nenhum.

Resposta: TriggerDraftView.

PUT /api/v2/triggers/:fullname

Cria ou guarda trigger completo.

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname. Deve coincidir com payload.fullname.

Payload:

Field	Required	Description
name	Sim	Trigger name dentro do project.
fullname	Sim	Trigger fullname.
project	Sim	Project fullname.
workspace	Sim	Workspace fullname.
backend	Sim	Backend object. Normalmente { type: "sdk", trigger, values }.
inputs	Sim	Input schema.
meta.title	Sim	Título visível.
meta.description	Não	Descrição.
defaults	Não	Notification defaults.
output	Não	Legacy output schema.
triggerSpec	Não	Source matching spec ou null.
providers	Não	Array of provider definitions.
filtersSchema	Não	Optional filters schema.
outputSchema	Não	Human/raw output schema.
transform	Não	JavaScript transform ou null.
activation	Não	JavaScript activation condition ou null.
executionPolicy	Não	Runtime limits override object ou null.
status	Não	{ status, issue, source, updatedAt }.
tags	Não	Tags.
labels	Não	Labels.

Resposta: TriggerDraftView.

PATCH /api/v2/triggers/:fullname

Atualiza trigger parcialmente.

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	Não	If true, validate patch without saving.

Resposta: TriggerPatchResult.

DELETE /api/v2/triggers/:fullname

Elimina trigger.

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname.

Payload: nenhum.

Resposta: OperationResult.

POST /api/v2/triggers/patch

Bulk patch para vários triggers.

Arguments: nenhum.

Payload:

Field	Required	Description
items	Sim	Array of { fullname, set?, unset? }.
dryRun	Não	Validate without saving.

Resposta: TriggerBulkPatchResult.

POST /api/v2/triggers/remove

Bulk remove para vários triggers.

Arguments: nenhum.

Payload:

Field	Required	Description
fullnames	Sim	Array of trigger fullnames.
dryRun	Não	Validate without deleting.

Resposta: TriggerBulkRemoveResult.

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

Devolve draft view de trigger.

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname.

Payload: nenhum.

Resposta: TriggerDraftView.

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

Guarda trigger draft.

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname.

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

Resposta: TriggerDraftView.

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

Valida trigger draft sem guardar definitivamente.

Arguments:

Argument	Location	Description
fullname	Path	Trigger fullname.

Payload: same shape as trigger save payload.

Resposta: TriggerValidationResult.

POST /api/v2/triggers/preview

Preview de output de transform/providers sem guardar trigger.

Arguments: nenhum.

Payload:

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

Resposta: TriggerPreviewResult.

POST /api/v2/triggers/test

Testa trigger definition em sample source item.

Arguments: nenhum.

Payload:

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

Resposta: TriggerTestResult.

POST /api/v2/triggers/test-block

Testa trigger num block específico.

Arguments: nenhum.

Payload:

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

Resposta: TriggerTestResult.

POST /api/v2/triggers/providers/test

Testa um provider.

Arguments: nenhum.

Payload:

Field	Required	Description
triggerSpec	Sim	Source matching spec.
provider	Sim	Provider definition.
project	Não	Project fullname.
workspace	Não	Workspace fullname.
templateValues	Não	Template values for provider placeholders.

Resposta: ProviderTestResult.

GET /api/v2/triggers/runtime-sources

Devolve runtime data sources disponíveis para trigger builder.

Arguments: nenhum.

Payload: nenhum.

Resposta: RuntimeSource[].

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

Encontra latest block/test input para trigger testing.

Arguments: nenhum.

Payload: trigger/source-specific search object.

Resposta: 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