> ## 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 SMS Configuration

> Update the SMS configuration for a phone number owned by the authenticated user.

> [!NOTE]
>
> **Enterprise Feature** - SMS is only available on Enterprise plans. Contact your Bland representative for access.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Body Parameters

**phone\_number** `string` *required*

The E.164 formatted phone number to update (must belong to the authenticated user).

**webhook** `string`

When the agent sends a response, we’ll send the message details in a POST request to the URL you specify here, along with chat history.

**request\_data** `object|array`

Request data fields are available to the AI agent during the call when referenced in the associated pathway or task.

**time\_out** `number`

Maximum time to wait for a user response, in seconds, before the timeout flow fires. Default is no timeout. Can be overridden per-conversation via `/v1/sms/send` or `/v1/sms/create`.

**timeout\_action** `string`

What to do when the timeout fires. Allowed values depend on your configuration (e.g. `"send_sms"` to send `timeout_message`).

**timeout\_message** `string`

Message sent when the timeout fires. Can be overridden per-conversation via `/v1/sms/send` or `/v1/sms/create`.

**warning\_time** `number`

Seconds to wait before sending the warning message. Must be less than `time_out`, otherwise the update is rejected. Can be overridden per-conversation via `/v1/sms/send` or `/v1/sms/create`.

**warning\_message** `string`

Message sent at `warning_time`. Can be overridden per-conversation via `/v1/sms/send` or `/v1/sms/create`.

**messaging\_service\_sid** `string`

Twilio Messaging Service SID, if set.

**objective** `string`

Assistant system prompt or conversational goal.

**tools** `array`

List of tools available to the assistant.

**temperature** `number`

The model’s temperature setting, controlling creativity.

**pathway\_id** `string`

The ID of the linked conversational pathway (if any).

**pathway\_version** `string`

The specific version of the pathway to use.

**start\_node\_id** `string`

Entry point node ID for the pathway.

**restart\_after\_end\_call** `boolean`

When `true`, a new conversation is automatically started if the user texts after the current conversation has ended. When `false`, subsequent messages are stored in the ended conversation without triggering a new reply.

**timezone** `string`

The timezone used for time-based variables in the conversation (e.g. `"America/New_York"`).

**summary\_prompt** `string`

Custom prompt used to generate a conversation summary when the conversation ends. When set, an AI-generated summary is included in the status webhook and stored on the conversation.

**disposition\_ids** `string[]`

An array of outcome IDs to run when conversations end on this number. See [Outcomes](https://docs.bland.ai/tutorials/outcomes.md).

**citation\_schema\_ids** `string[]`

An array of citation schema IDs to extract when conversations end on this number. See [Citations](https://docs.bland.ai/enterprise-features/citations.md).

### Response

**data** `object`

Contains a confirmation message and the updated SMS configuration.

**data.message** `string`

Success message confirming the update.

**data.sms\_config** `object`

The updated and sanitized SMS configuration object.

**errors** `null|array`

`null` on success. If an error occurs, this will be an array of error objects.

**errors\[].message** `string`

A human-readable description of the error.

**errors\[].error** `string`

A machine-readable error code.

```json Response theme={null}
{
  "data": {
    "message": "SMS config updated for number +15550001111",
    "sms_config": {
      "webhook": null,
      "request_data": [],
      "time_out": null,
      "timeout_action": null,
      "timeout_message": null,
      "warning_time": null,
      "warning_message": null,
      "messaging_service_sid": null,
      "objective": "Chat with the user",
      "tools": [],
      "temperature": 0,
      "pathway_id": null,
      "pathway_version": null,
      "start_node_id": null,
      "restart_after_end_call": true,
      "timezone": null,
      "summary_prompt": null,
      "disposition_ids": null,
      "citation_schema_ids": null
    }
  },
  "errors": null
}
```

***

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.