Sign in
Functions

Create trigger

Schedule or subscribe the function. cron uses a 5-field expression with an optional IANA timezone; once fires a single time at run_at; s3 fires on Object Storage bucket events (optionally filtered by key prefix/suffix). Deliveries are signed CloudEvents (HMAC X-Raff-Signature) with 3 retry attempts. Triggers are free.

post/api/v1/functions/{function_id}/triggers

Path parameters

function_idstring required

Function ID, short id (fn-…), URL slug, or name

Request body

trigger_type'cron' | 'once' | 's3' required
cron_expressionstring

5-field cron (required for cron)

timezonestring

IANA name, default UTC

run_atstring date-time

Required for once

payload_jsonstring

JSON merged into the CloudEvent data (cron/once)

bucket_idstring uuid

Required for s3 — an Object Storage bucket you own

s3_eventsstring[]

Default s3:ObjectCreated:; also s3:ObjectRemoved:

key_prefixstring

Only objects whose key starts with this fire the trigger

key_suffixstring

Only objects whose key ends with this fire the trigger

Response

Trigger created

successboolean

Changes