Oh Dear: Installation & Configuration

Installation

The Oh Dear provider is available for Node.js/TypeScript and Python.

npm install @matthiashamacher/ohdear

pip install matthiashamacher_ohdear

The provider is a native (Go) plugin. Pulumi downloads it automatically from the package’s pluginDownloadURL; to install it by hand:

pulumi plugin install resource ohdear <version> \
  --server github://api.github.com/matthiashamacher/pulumi-ohdear

Authentication

Every Oh Dear API call uses one token, sent as Authorization: Bearer <token>. Create a token under Account → API tokens in Oh Dear (https://ohdear.app/user/api-tokens).

Provide it in one of two ways:

Environment variable

export OHDEAR_API_TOKEN="your-api-token"

Pulumi configuration

pulumi config set --secret ohdear:apiToken "your-api-token"

Explicit config wins over the environment variable. If neither is set, the provider fails at startup with a clear error.

Configuration reference

Finding IDs

Most resources need a numeric teamId. List your teams and their IDs with:

curl https://ohdear.app/api/me \
  -H "Authorization: Bearer $OHDEAR_API_TOKEN" \
  -H 'Accept: application/json'