# Update a Custom Model Provider (https://www.shipfox.io/docs/how-to/set-up-work/update-custom-model-provider)

Description: Change one custom endpoint configuration and verify it with an agent run.

Update a custom provider when its endpoint, authentication, headers, models, or
default model changes. The provider ID stays the same, so workflow references do
not need a rename.

## Before you begin [#before-you-begin]

You need workspace agent-settings access and the new endpoint configuration.
Keep the old endpoint or credential active until verification succeeds.

## Find affected workflows [#find-affected-workflows]

Search workflow files in the project for the custom provider ID. Check the workspace
default provider too because steps may omit `provider`.

Choose a workflow that names a model you plan to keep.

## Update the provider [#update-the-provider]

### Open the custom provider

Open **Settings → Agents**. Open the custom provider's menu and select
**Edit**.

### Update the connection

Change the endpoint, protocol, headers, or models. Enter a new API key when
it changed. Leave it blank to keep the stored key.

### Test and save

Choose a valid default model, then select **Test & save**.

If the base URL changes, re-enter stored secret values instead of trying to
reuse them for the new host.

## Verify the update [#verify-the-update]

Run the representative workflow. Open its agent step and confirm that it uses
the custom provider, resolves an expected model, and returns a response.

Retire the old endpoint or credential only after the run succeeds. Use [Fix
agent failures](https://www.shipfox.io/docs/how-to/run-and-troubleshoot/agent-provider-failures) if the
endpoint test passes but the workflow fails.