> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Web Agent Settings

> Update your web agent's settings, prompt and other details.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**agent\_id** `string`

The web agent you'll be updating.

### Body

**prompt** `string` *required*

Provide instructions, relevant information, and examples of the ideal conversation flow.

> [accordion] Best Practices
>
> #### Out-of-the-Box Behaviors (Summarized):
>
> * Speech pattern: Direct, concise, casual
> * Spells out symbols, acronyms, abbreviations, percentages, etc. (\$4,000,000 -> "four million dollars")
> * Asks clarifying questions
>
> #### Prompting Tips:
>
> * Want to easily test out exactly how your agent will behave?
>   * [Try out Agent Testing!](https://app.bland.ai/home?page=testing)
> * Aim for less than >2,000 characters where possible.
> * Simple, direct prompts are the most predictable and reliable.
> * Frame instructions positively:
>   * `"Do this"` rather than `"Don't do this"`.
>   * Ex. "Keep the conversation casual" rather than "Don't be too formal".
>   * This gives concrete examples of what to do, instead of leaving expected behavior open to interpretation.

**voice** `string`

Set your agent's voice - all available voices can be found with the [List Voices](https://docs.bland.ai/api-v1/get/voices.md) endpoint.

**webhook** `string`

Set a webhook URL to receive call data after the web call completes.

**metadata** `object`

Add any additional information you want to associate with the call. This can be useful for tracking or categorizing calls.

**pathway\_id** `string`

Set the pathway that your agent will follow. This will override the `prompt` field, so there is no need to pass the 'prompt' field if you are setting a pathway.

Warning: Setting a pathway will set the following fields to `null` / their default value - `prompt`, `first_sentence`, `model`, `dynamic_data`, `tools`, `transfer_list`

Set to `null` or an empty string to clear the pathway.

**language** `string` (default: ENG)

Select a supported language of your choice.
Optimizes every part of our API for that language - transcription, speech, and other inner workings.

Supported Languages and their codes can be found [here](https://docs.bland.ai/api-v1/post/calls.md#param-language).

**webhook** `string`

The webhook should be a http / https callback url. We will send the call\_id
and transcript to this URL after the call completes. This can be useful if you
want to have real time notifications when calls finish.

Set to `null` or an empty string to clear the webhook.

**model** `string` (default: base)

Select a model to use for your call.

Options: `base` or `turbo`.

In nearly all cases, `base` is the best choice for now.

> [accordion] Model Differences
>
> There are two different ways to use Bland:
>
> * `model: base`
>   * The original, follows scripts/procedures most effectively.
>   * Supports all features and capabilities.
>   * Best for Custom Tools
> * `model: turbo`
>   * The absolute fastest latency possible, can be verbose at times
>   * Limited capabilities currently (excludes Transferring, IVR navigation, Custom Tools)
>   * Extremely realistic conversation capabilities

**first\_sentence** `string`

A phrase that your call will start with instead of a generating one on the fly. This works both with and without `wait_for_greeting`. Can be more than one sentence, but must be less than 200 characters.

To remove, set to `null` or an empty string.

**tools** `array`

Interact with the real world through API calls.

Detailed tutorial here: [Custom Tools](https://docs.bland.ai/tutorials/custom-tools)

**dynamic\_data** `object`

Integrate data from external APIs into your agent's knowledge.

Set to `null` or an empty string to clear dynamic data settings.

Detailed usage in the [Send Call](https://docs.bland.ai/api-v1/post/calls.md) endpoint.

**interruption\_threshold** `number` (default: 500)

Legacy. Sets a fixed wait, in milliseconds, after the caller stops speaking before the AI responds. We recommend leaving this unset: response timing adapts to each caller automatically (see [Agent Speech](https://docs.bland.ai/tutorials/agent-speech.md)).

To control how readily the AI stops when the caller talks over it, use `interruptibility`.

**interruptibility** `integer` (default: 2)

Controls how readily the AI stops speaking when the caller talks over it. A higher value yields more easily; a lower value holds the turn through more of the caller's speech.

* `0`: Block. The AI ignores interruptions and finishes speaking (same as `block_interruptions: true`).
* `1`: Difficult. Harder to interrupt.
* `2`: Balanced (default).
* `3`: Easy. The AI stops quickly when the caller begins speaking.
* `4`: Always interrupt. Any caller speech stops the AI, including brief acknowledgments like "uh-huh".

See [Agent Speech](https://docs.bland.ai/tutorials/agent-speech.md) for how each level behaves.

**max\_duration** `integer (minutes)` (default: 30)

The maximum duration that calls to your agent can last before being automatically terminated.

Set to `null` to reset to default.

### Response

**status** `string`

Whether the update was successful or not - will be `success` or `error`.

**message** `string`

A message describing the status of the update.

**updates** `object`

An object containing the updated settings for the agent.

**failed\_updates** `object`

If the update was unsuccessful, this will contain the settings that failed to update. Useful to determine how your request is being interpreted on our end.

```json Response theme={null}
{
    "status": "success",
    "message": "Successfully updated agent 46f37229-7d12-44be-b343-6e68274cfbea.",
    "updates": {
        "model": "base"
    }
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.