Knowledge & tools

Tool presets & credentials

Many integrations need an API key or token. Hania stores those secrets securely and makes common setups one click with presets.

Presets

A preset is a ready-made starting point for a tool type — the configuration filled in for a common integration, so you only supply what's unique to you (usually a credential). Browse presets in the tool catalog when you create a tool; pick one and fill in the blanks rather than configuring from scratch.

Credentials are write-only

When a tool needs a secret (an API key, token, or password), you provide it in the tool's configuration when you create or update the tool. Hania encrypts it at rest and never returns it. Reading a tool back shows only secrets_set — the names of the fields that have a secret stored — not the values.

Because secrets are never returned, to change one you send the new value; to keep the existing one you simply omit it. You can't read a stored secret back out — rotate it by sending a new value.

One credential, many bots

A tool configuration lives at the workspace level, so a single credentialed tool can be assigned to multiple bots. When you assign a credentialed tool to a bot, you reference the tool configuration — the secret stays in one place. See the Tools API for the exact fields.