Blnk Cloud Custom App

Author Blnk Watch rules in a real editor, stored in your Git repo.

Write, version, and ship .ws watch scripts from a focused web portal. Your repository is the source of truth — the same URL you paste into Blnk Watch.

large_transactions.wsmain
# Notify the ops channel on large applied transactions

rule "large_transactions" {
  when {
    transaction.amount > 10000
    transaction.status == "applied"
    transaction.currency == "USD"
  }

  then {
    action.send_notification(
      channel: "slack",
      message: "Large transaction ${transaction.reference} for ${transaction.amount}"
    )
    action.tag(transaction, "high_value")
  }
}

How it works

From install to live rules in four steps.

  1. 01

    Install the app

    Add the app from the Blnk Cloud apps directory. Blnk provisions a scoped API key and grants permissions.

  2. 02

    Connect a Git repo

    Open the portal and paste any HTTPS Git URL. Add a token if the repo is private. We verify the connection.

  3. 03

    Write & save scripts

    Author .ws rule files in the editor. Saving commits and pushes back to your repo on the configured branch.

  4. 04

    Use the URL in Blnk Watch

    Configure your Blnk Watch setup to pull from the same repo URL. One pipeline, end to end.

Features

A focused tool for the people writing your watch rules.

Git-backed source of truth

Every script is a file in a repo you own. Branch, review, audit, roll back — all from your existing developer tooling.

First-class .ws editor

Monaco editor with syntax highlighting tuned to the Blnk Watch rule DSL. Write rules with confidence.

Plug into Blnk Watch

Once configured, paste the same Git URL into your Blnk Watch setup. Scripts you save here are what runs there.

Encrypted at rest

Blnk API keys and Git tokens are stored encrypted with AES-256-GCM. Portal sessions are short-lived JWTs.

Lifecycle endpoints

The webhooks Blnk calls.

Configure these on your Blnk Custom App. Replace the host with this app's public URL.

POST/api/callback

Handles install and uninstall events. Dispatches on the event type field.

POST/api/portal

Mints a short-lived signed portal URL when a user opens the app.