- Making the same change on many agents, or copying an agent for a new location.
- Reviewing recent calls and suggesting better instructions.
- Explaining what an agent is set up to do, in plain language.
Safety rules
Follow these rules every time you give an assistant access to your agents.1. Use the narrowest API key
Partners create API keys. A partner creates a dedicated key for the assistant under Account Settings → API Keys and scopes it to the one reseller or organization the assistant should work on, using the key’s Access setting. A scoped key can only read and change that organization’s or reseller’s data, and it is refused for account-level endpoints such as the billing report. See Scoped API keys.Keys are not read-only: any key that can read an agent can also change it. Limit what the assistant can reach with the key’s Access, and use the propose-then-approve flow below to control what it changes.
- Only partners create API keys and choose their scope. Reseller admins can rotate the keys a partner issued to them, but can’t create new ones. Each key is a client ID and a client secret.
- Give the assistant the key through an environment variable or your tool’s secret settings. Never paste it into a shared chat or commit it to a repository.
- When you’re done, Delete the key on the API Keys page, or Rotate it if it may have been exposed. Rotation keeps the client ID and replaces the secret, and tokens issued before the rotation stop working.
2. Propose, then approve
Tell the assistant to show you the exact change before it makes it:- The assistant reads the agent with Get Agent.
- It shows you the fields it will change, with the old and new values.
- You approve, and only then does it call Update Agent.
- It reads the agent again to confirm the change was saved.
3. Know how to undo
Every settings change is saved in the agent’s Change History, the same record you see in the Telzino Dashboard and the Connect App. If a change goes wrong:- List Agent Change History shows each change, who made it and the old and new values.
- Revert Agent to a Version puts the agent back to how it was at that version. The revert is saved as a new version, so it can be undone too.
Next steps
Runbook for AI assistants
The steps an assistant follows to change an agent safely.
Connecting tools
Give ChatGPT, Claude or Cursor the docs and a key, plus a starter prompt.
Example prompts
Ready-made prompts for common changes.
