Triggers

Create a trigger

Changed on

Create a trigger with an activation type of event, schedule, or custom. Each type requires its own fields (e.g. eventType and optional conditions for events, scheduleRule and timezone for schedules, customPayloadSchema for custom triggers); mismatched fields are rejected.

Supports an optional Idempotency-Key header (1-255 printable ASCII characters). Replays with the same key and an identical body return the original 201; a changed body under the same key returns 422 idempotency_key_reused.

post/triggers

Request

  • Base URL
    https://api.mobilerun.ai
  • URL
    https://api.mobilerun.ai/triggers
  • Auth
    HTTP bearer

Headers

idempotency-keystring

Idempotency-Key: 1-255 printable ASCII characters. Same key with a different request body is a 422 idempotency_key_reused. A retryable in-flight duplicate is a 409 with Retry-After and x-should-retry: true; a terminal duplicate is a 409 with x-should-retry: false. A replay returns the current resource state with Idempotent-Replayed: true.

Example:b3f6a9f0-6f1a-4e9a-9e7a-9c9b6b6a5a3f

Request body

namestring required
descriptionstring
activation'event' | 'schedule' | 'custom' required
eventTypestring
timezonestring
customPayloadSchemaCustomPayloadSchema

Optional JSON Schema for validating payloads sent to this custom trigger

Response

Trigger created

Changes

    • breaking

      the / response's property format changed from no format to date-time for status

    • breaking

      the / response's property format changed from no format to date-time for status

    • info

      added the new optional header request parameter idempotency-key

    • info

      added the non-success response with the status

    • info

      added the new optional request property /

    • info

      added the optional property // to the response with the status