> ## 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 Inbound Number Label

> Update the label shown for one of your inbound phone numbers.

### Headers

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

### Body

<ParamField body="phoneNumber" type="string" required>
  The inbound phone number whose label you want to update.

  Required format: E.164 (for example, `+12223334444`).
</ParamField>

<ParamField body="newLabel" type="string" required>
  The new label to assign to this inbound number.

  Constraints:

  * Max length: `150` characters
  * Set to an empty string (`""`) to clear the label
</ParamField>

### Response

<ResponseField name="data" type="object">
  Success response data.
</ResponseField>

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

<ResponseField name="data.phone_number" type="string">
  The inbound phone number that was updated.
</ResponseField>

<ResponseField name="data.label" type="string">
  The updated label value.
</ResponseField>

<ResponseField name="errors" type="null">
  Error array (null on success).
</ResponseField>

<ResponseExample>
  ```json Success theme={null}
  {
    "data": {
      "message": "Label updated successfully",
      "phone_number": "+18669659045",
      "label": "apitest"
    },
    "errors": null
  }
  ```

  ```json Invalid request body (400) theme={null}
  {
    "data": null,
    "errors": [
      {
        "error": "INVALID_REQUEST",
        "message": "Invalid request body"
      }
    ]
  }
  ```

  ```json Label too long (400) theme={null}
  {
    "data": null,
    "errors": [
      {
        "error": "LABEL_TOO_LONG",
        "message": "Label is too long"
      }
    ]
  }
  ```

  ```json Auth failure (401) theme={null}
  {
    "data": null,
    "errors": [
      {
        "error": "AUTH_FAILURE",
        "message": "Unauthorized"
      }
    ]
  }
  ```

  ```json Not found (404) theme={null}
  {
    "error": "Phone number not found"
  }
  ```
</ResponseExample>

***

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