manage_trigger
Manage triggers. A webhook trigger fires a signed HTTP POST when records/relationships change; an internal_write trigger makes Rekor patch a referenced record itself (no executor); an external_write trigger writes the changed record out through an external source's write path (reusing its translation, endpoint, and auth) and links the upstream-assigned id back (no executor).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
action | enum: create | get | list | delete | Yes | |
base_id | string | Yes | Target database ID |
trigger_id | string | No | Trigger ID. Required for get, delete. Auto-generated for create if omitted. |
name | string | No | Trigger display name |
url | string | No | Webhook HTTPS endpoint (webhook triggers) |
secret | string | No | Webhook HMAC signing secret (webhook triggers) |
action_config | object | No | Polymorphic action. Webhook: {type:'webhook',url,secret}. internal_write: {type:'internal_write',target,match:{source_field,target_key?},patch,precondition?,mode:'async'|'transactional'} (mode 'async' applies after the triggering write; 'transactional' applies atomically with it so a precondition miss rolls the write back). external_write: {type:'external_write',record_type?,source,op?,link_external_id?,watched_fields?} — writes the changed record through that record_type's source ('record_type' defaults to the triggering record_type); 'op' defaults from the event (created→create, updated→update, deleted→delete); on a create the upstream-assigned id is linked back as external_id unless link_external_id:false. watched_fields scopes UPDATE dispatch to writes that changed an upstream-mapped field (skips a redundant push when only a rekor-owned overlay field changed): 'mapped' = the source's to_external keys, or an explicit array of data fields; omit to fire on every update. Takes precedence over url/secret. |
events | array | No | Events to fire on: record.created, record.updated, record.deleted, relationship.created, relationship.updated, relationship.deleted, file.created, file.updated, file.deleted (internal_write supports record.created/updated only; external_write supports record.created/updated/deleted only; file events are webhook-only) |
record_type_scope | array | No | Limit to specific record_types |
filter | object | No | Only fire when record matches this filter |
skip_inbound_webhook_writes | boolean | No | Skip firing on inbound-webhook-originated writes (default true) |
skip_cascade_writes | boolean | No | Skip firing on cascade-originated (internal_write) writes (default true) |