How to define variables/constants in KeepHQ (K8s hosted) and reference them in workflows?

[MikhailOnyanov]

Hi everyone!
I’m running KeepHQ in a self-hosted Kubernetes setup and I'm wondering how to define reusable variables/constants and access them from workflows.

What I want to do:

1. Store shared values like base URLs, room IDs, default headers, etc.
2. Reference them in templates inside steps (HTTP provider, console, etc.).

Is there UI for this?

[dosubot[bot]]

Hi @MikhailOnyanov! I'm Dosu and I’m helping the keep team.

You can define reusable variables/constants in KeepHQ workflows by adding a consts block at the top of your workflow YAML. For example:

consts:
  base_url: "https://api.example.com"
  default_headers:
    Authorization: "Bearer xyz"
  slack_channels:
    sre_team: CH00001
    payments_team: CH00002

Reference these constants in your workflow steps or actions using templating syntax, like {{ consts.base_url }} or {{ consts.slack_channels.sre_team }}. This works in any provider step, including HTTP and console steps. For example:

steps:
  - name: call-api
    provider:
      type: http
      with:
        url: "{{ consts.base_url }}/endpoint"
        headers: "{{ consts.default_headers }}"

There is no UI for managing these variables/constants—they are defined directly in the workflow YAML files. For sensitive values, use Kubernetes Secrets and inject them as environment variables into your KeepHQ pods; this is separate from workflow-level constants and is managed at the infrastructure level, not in the workflow YAML or UI source source.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[talboren]

Hey @MikhailOnyanov,

We currently do not support consts/variables/secrets that are shared throughout entire workflows, but it's a great idea to add to Keep. Would you consider contributing it?

[MikhailOnyanov]

Sounds great! Should we move this to the ideas thread, or do you already have a thread where you propose and discuss improvements to Keep?