> ## 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.

<Info>
  **Enterprise Feature** - SMS is only available on Enterprise plans. Contact your Bland representative for access.
</Info>

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Body Parameters

<ParamField body="phone_number" type="string" required>
  The E.164 formatted phone number to update (must belong to the authenticated user).
</ParamField>

<ParamField body="webhook" type="string" required={false}>
  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.
</ParamField>

<ParamField body="request_data" type="object|array" required={false}>
  Request data fields are available to the AI agent during the call when referenced in the associated pathway or task.
</ParamField>

<ParamField body="time_out" type="number" required={false}>
  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`.
</ParamField>

<ParamField body="timeout_action" type="string" required={false}>
  What to do when the timeout fires. Allowed values depend on your configuration (e.g. `"send_sms"` to send `timeout_message`).
</ParamField>

<ParamField body="timeout_message" type="string" required={false}>
  Message sent when the timeout fires. Can be overridden per-conversation via `/v1/sms/send` or `/v1/sms/create`.
</ParamField>

<ParamField body="warning_time" type="number" required={false}>
  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`.
</ParamField>

<ParamField body="warning_message" type="string" required={false}>
  Message sent at `warning_time`. Can be overridden per-conversation via `/v1/sms/send` or `/v1/sms/create`.
</ParamField>

<ParamField body="messaging_service_sid" type="string" required={false}>
  Twilio Messaging Service SID, if set.
</ParamField>

<ParamField body="objective" type="string" required={false}>
  Assistant system prompt or conversational goal.
</ParamField>

<ParamField body="tools" type="array" required={false}>
  List of tools available to the assistant.
</ParamField>

<ParamField body="temperature" type="number" required={false}>
  The model’s temperature setting, controlling creativity.
</ParamField>

<ParamField body="pathway_id" type="string" required={false}>
  The ID of the linked conversational pathway (if any).
</ParamField>

<ParamField body="pathway_version" type="string" required={false}>
  The specific version of the pathway to use.
</ParamField>

<ParamField body="start_node_id" type="string" required={false}>
  Entry point node ID for the pathway.
</ParamField>

<ParamField body="restart_after_end_call" type="boolean" required={false}>
  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.
</ParamField>

<ParamField body="timezone" type="string" required={false}>
  The timezone used for time-based variables in the conversation (e.g. `"America/New_York"`).
</ParamField>

<ParamField body="summary_prompt" type="string" required={false}>
  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.
</ParamField>

<ParamField body="disposition_ids" type="string[]" required={false}>
  An array of outcome IDs to run when conversations end on this number. See [Outcomes](/tutorials/outcomes).
</ParamField>

<ParamField body="citation_schema_ids" type="string[]" required={false}>
  An array of citation schema IDs to extract when conversations end on this number. See [Citations](/enterprise-features/citations).
</ParamField>

### Response

<ResponseField name="data" type="object">
  Contains a confirmation message and the updated SMS configuration.
</ResponseField>

<ResponseField name="data.message" type="string">
  Success message confirming the update.
</ResponseField>

<ResponseField name="data.sms_config" type="object">
  The updated and sanitized SMS configuration object.
</ResponseField>

<ResponseField name="errors" type="null|array">
  `null` on success. If an error occurs, this will be an array of error objects.
</ResponseField>

<ResponseField name="errors[].message" type="string">
  A human-readable description of the error.
</ResponseField>

<ResponseField name="errors[].error" type="string">
  A machine-readable error code.
</ResponseField>

<ResponseExample>
  ```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
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)