Register per tenant
How multi-tenancy works
One URL, one token per merchant. You register the same endpoint for every
tenant with a different
auth_token, and your server resolves which merchant
from that token.No tenant id travels in the URL or the tool arguments — so there is nothing for
a confused model, or a determined customer, to change. The isolation is in a
credential the conversation never sees.label; the row is
updated in place.
Allowed hosts
Tool server hosts are allowlisted. Your hosts are added to your partner record once, after which you can register any path on them without further approval. Send us the hostname when you onboard. An unlisted host returns:What happens to your tool descriptions
Descriptions reach the model’s prompt, so they are treated as untrusted input: capped at 400 characters, flattened to one paragraph, and stripped of instruction-shaped phrases. Names are namespaced per server, and a name that collides with a built-in (finish_turn, create_booking, …) is refused rather
than renamed.
Write descriptions for a colleague who has never seen your API. That is
genuinely the highest-leverage thing you can do for answer quality.
Building the server
The tool contract, result shapes, and side-effect rules.

