Replace a Model Provider Key
Save a new provider key. Verify a run before revoking the old key.
Replace a provider key while the old one still works. Shipfox tests the new key before saving it.
Before you begin
You need access to agent settings and a new provider key. You also need a test project with an online runner.
Keep the old key active until the test run succeeds.
Find affected agent steps
Search project workflow files for the provider ID. Also check the workspace
default provider. A step that omits provider may resolve to that default.
Choose one workflow that uses the provider and a model your team needs.
Replace the credential
- Open Settings → Agents.
- Open the configured provider's menu and select Edit credentials.
- Enter the new key and any other required values.
- Select Test & save.
If the live test fails, Shipfox keeps the current setup. Fix the new key before trying again.
Verify and retire the old credential
Re-run the representative workflow. Confirm that its agent step resolves the same provider and model, returns a response, and finishes successfully.
After the run succeeds, revoke the old key at the provider. Run the workflow again if revocation takes time.
Use Fix agent failures if the verification run reports a credential or provider error.