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

# Numbers Update

> Update configuration settings for one or more phone numbers. Modify message routes, voice routes, capabilities, and other number attributes. Changes take effect immediately.

**What this does:** Returns confirmation of the updated number configuration. Changes apply immediately. You can change the message route, voice route, subscriber assignment, or number settings in a single call.

**Next steps:**
- Confirm the update — `GET /v1.0/numbers`
- Check inventory — `GET /v1.0/numbers/inventory`



## OpenAPI

````yaml /api-reference/openapi.json post /v1.0/numbers/update
openapi: 3.0.3
info:
  title: mPaaS Core APIs
  version: 1.0.8
  description: >-
    The Telegent mPaaS (Mobile Platform as a Service) API gives you full
    programmatic control over mobile phone numbers, messaging, voice routing,
    subscribers, and account management. Use these APIs to provision MVNO and
    IoT numbers, send and receive SMS/MMS, configure intelligent call routing,
    manage subscriber accounts, and apply AI Guardian controls. All requests
    require a Bearer token obtained from the Authentication endpoint. For
    support, visit https://support.telegent.com/support/home
  contact:
    name: Support
    email: support@telegent.com
  termsOfService: https://telegent.com/terms
  license:
    name: Use under LICX
    url: https://telegent.com/license
servers:
  - url: https://api.telegent.com
security:
  - BearerAuth: []
tags:
  - name: OAuth2
  - name: AI Guardian
  - name: Accounts
  - name: Distributors
  - name: Message
  - name: Numbers
  - name: Voicemail
  - name: Packages
  - name: Products
  - name: Schedules
  - name: Services
  - name: Sims
  - name: Subscribers
  - name: Subscriptions
  - name: Voice
  - name: Workgroups
paths:
  /v1.0/numbers/update:
    post:
      tags:
        - Numbers
      summary: Numbers Update
      description: >-
        Update configuration settings for one or more phone numbers. Modify
        message routes, voice routes, capabilities, and other number attributes.
        Changes take effect immediately.


        **What this does:** Returns confirmation of the updated number
        configuration. Changes apply immediately. You can change the message
        route, voice route, subscriber assignment, or number settings in a
        single call.


        **Next steps:**

        - Confirm the update — `GET /v1.0/numbers`

        - Check inventory — `GET /v1.0/numbers/inventory`
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - Number
              properties:
                Number:
                  type: string
                  description: Phone number to update (E.164 format)
                  example: '+18018018011'
                AccountId:
                  type: string
                  description: >-
                    Account ID (AID) the number belongs to. Required when a
                    distributor account has more than one sub-account.
                  example: AID-ab12345-2725-45a1-bd5e-526ed19799xx
                MessageEnabled:
                  type: boolean
                  description: Enable/disable SMS/MMS capabilities
                  example: true
                MessageType:
                  type: string
                  enum:
                    - a2p
                    - p2p
                  description: Message type
                  example: p2p
                Classification:
                  type: string
                  enum:
                    - MVNO
                    - IoT
                  description: Number classification
                  example: MVNO
                VoiceEnabled:
                  type: boolean
                  description: Enable/disable voice capabilities
                  example: true
                MessageRouteId:
                  type: string
                  description: MRID for message routing
                  example: MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee
                VoiceRouteId:
                  type: string
                  description: CRID for voice routing
                  example: CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe
                AssignedSubscriberId:
                  type: string
                  description: >-
                    Telegent Subscriber ID. Format: `TSUID-` followed by a UUID.
                    Create one via `POST /v1.0/subscribers/create` or look up
                    existing IDs with `GET /v1.0/subscribers/get`.
                  example: TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d
                Iccid:
                  type: string
                  description: SIM card ICCID (for IoT/MVNO)
                  example: '8901240397190556232'
                CnamFirstName:
                  type: string
                  description: Caller ID first name
                  example: John
                CnamLastName:
                  type: string
                  description: Caller ID last name
                  example: Doe
                ProductType:
                  type: string
                  enum:
                    - Sms-Only
                    - Data-Only
                    - Sms+Data
                    - Sms+Data+Voice
                  description: Product type for the number
                  example: Data-Only
      responses:
        '200':
          description: Numbers Update
          content:
            application/json:
              schema:
                type: object
              examples:
                example:
                  value:
                    Number: '+18018018011'
                    Tnid: null
                    UpdateOrderId: JNUOID-9ac74103-bf27-474a-8a1a-9f4ff74af187
                    UpdateOrderDate: '2025-05-14T22:21:08.2813656+00:00'
                    UpdateOrderStatus: Complete
                    MessageType: p2p
                    MessageEnabled: true
                    Classification: MVNO
                    VoiceEnabled: true
                    MessageRouteId: MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee
                    VoiceRouteId: CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe
                    Iccid: 8901240397190557414F
                    CnamFirstName: John
                    CnamLastName: Doe
                    ProductType: Data-Only
        '400':
          description: Bad Request
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/BadRequest_Result'
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequest_Result'
              examples:
                example:
                  value:
                    StatusCode: 400
                    Message: >-
                      Bad request: one or more required fields are missing or
                      contain an invalid value.
            text/json:
              schema:
                $ref: '#/components/schemas/BadRequest_Result'
        '401':
          description: Unauthorized
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/Unauthorized_Result'
            application/json:
              schema:
                $ref: '#/components/schemas/Unauthorized_Result'
              examples:
                example:
                  value:
                    StatusCode: 401
                    Message: >-
                      Unauthorized: Bearer token is missing, expired, or
                      invalid. Re-authenticate via POST /v1.0/oauth2/tokens.
            text/json:
              schema:
                $ref: '#/components/schemas/Unauthorized_Result'
        '403':
          description: Forbidden
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/Forbidden_Result'
            application/json:
              schema:
                $ref: '#/components/schemas/Forbidden_Result'
              examples:
                example:
                  value:
                    StatusCode: 403
                    Message: >-
                      Forbidden: your token does not have permission to access
                      this resource. Check the ApiEndpoint scope.
            text/json:
              schema:
                $ref: '#/components/schemas/Forbidden_Result'
        '404':
          description: Not Found
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/NotFound_Result'
            application/json:
              schema:
                $ref: '#/components/schemas/NotFound_Result'
              examples:
                example:
                  value:
                    StatusCode: 404
                    Message: >-
                      Not found: the requested resource does not exist or
                      belongs to a different account.
            text/json:
              schema:
                $ref: '#/components/schemas/NotFound_Result'
        '405':
          description: Method Not Allowed
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/MethodNotAllowed_Result'
            application/json:
              schema:
                $ref: '#/components/schemas/MethodNotAllowed_Result'
              examples:
                example:
                  value:
                    StatusCode: 405
                    Message: >-
                      Method not allowed: verify the HTTP method required for
                      this endpoint.
            text/json:
              schema:
                $ref: '#/components/schemas/MethodNotAllowed_Result'
        '408':
          description: Request Timeout
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/RequestTimeout_Result'
            application/json:
              schema:
                $ref: '#/components/schemas/RequestTimeout_Result'
              examples:
                example:
                  value:
                    StatusCode: 408
                    Message: >-
                      Request timeout: the server did not receive a complete
                      request within the allowed time. Retry with exponential
                      backoff.
            text/json:
              schema:
                $ref: '#/components/schemas/RequestTimeout_Result'
        '429':
          description: Too Many Requests
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/TooManyRequests_Result'
            application/json:
              schema:
                $ref: '#/components/schemas/TooManyRequests_Result'
              examples:
                example:
                  value:
                    StatusCode: 429
                    Message: >-
                      Too many requests: rate limit exceeded. Slow your request
                      cadence and retry after a short delay.
            text/json:
              schema:
                $ref: '#/components/schemas/TooManyRequests_Result'
        '500':
          description: Server Error
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/InternalServerError_Result'
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError_Result'
              examples:
                example:
                  value:
                    StatusCode: 500
                    Message: >-
                      Internal server error: an unexpected error occurred. If
                      the problem persists contact support@telegent.com.
            text/json:
              schema:
                $ref: '#/components/schemas/InternalServerError_Result'
        '503':
          description: Service Unavailable
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ServiceUnavailable_Result'
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceUnavailable_Result'
              examples:
                example:
                  value:
                    StatusCode: 503
                    Message: >-
                      Service unavailable: the API is temporarily unavailable.
                      Retry after a short delay.
            text/json:
              schema:
                $ref: '#/components/schemas/ServiceUnavailable_Result'
        '504':
          description: Gateway Timeout
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/GatewayTimeout_Result'
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayTimeout_Result'
              examples:
                example:
                  value:
                    StatusCode: 504
                    Message: >-
                      Gateway timeout: an upstream service did not respond in
                      time. Retry with exponential backoff.
            text/json:
              schema:
                $ref: '#/components/schemas/GatewayTimeout_Result'
      x-codeSamples:
        - lang: JSON
          source: |-
            {
              "Number": "+18018018011",
              "AccountId": "AID-ab12345-2725-45a1-bd5e-526ed19799xx",
              "MessageEnabled": true,
              "MessageType": "p2p",
              "Classification": "MVNO",
              "VoiceEnabled": true,
              "MessageRouteId": "MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee",
              "VoiceRouteId": "CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe",
              "AssignedSubscriberId": "TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d",
              "Iccid": "8901240397190556232",
              "CnamFirstName": "Test",
              "CnamLastName": "User",
              "ProductType": "Data-Only"
            }
        - lang: cURL
          source: |-
            curl -X POST https://api.telegent.com/v1.0/numbers/update \
              -H 'Authorization: Bearer YOUR_TOKEN' \
              -H 'Content-Type: application/json' \
              -d '{
                "Number": "+18018018011",
                "AccountId": "AID-ab12345-2725-45a1-bd5e-526ed19799xx",
                "MessageEnabled": true,
                "MessageType": "p2p",
                "Classification": "MVNO",
                "VoiceEnabled": true,
                "MessageRouteId": "MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee",
                "VoiceRouteId": "CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe",
                "AssignedSubscriberId": "TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d",
                "Iccid": "8901240397190556232",
                "CnamFirstName": "Test",
                "CnamLastName": "User",
                "ProductType": "Data-Only"
              }'
components:
  schemas:
    BadRequest_Result:
      required:
        - StatusCode
      type: object
      properties:
        StatusCode:
          type: integer
          format: int32
        Message:
          type: string
          nullable: true
      additionalProperties: false
    Unauthorized_Result:
      required:
        - StatusCode
      type: object
      properties:
        StatusCode:
          type: integer
          format: int32
        Message:
          type: string
          nullable: true
      additionalProperties: false
    Forbidden_Result:
      required:
        - StatusCode
      type: object
      properties:
        StatusCode:
          type: integer
          format: int32
        Message:
          type: string
          nullable: true
      additionalProperties: false
    NotFound_Result:
      required:
        - StatusCode
      type: object
      properties:
        StatusCode:
          type: integer
          format: int32
        Message:
          type: string
          nullable: true
      additionalProperties: false
    MethodNotAllowed_Result:
      required:
        - StatusCode
      type: object
      properties:
        StatusCode:
          type: integer
          format: int32
        Message:
          type: string
          nullable: true
      additionalProperties: false
    RequestTimeout_Result:
      required:
        - StatusCode
      type: object
      properties:
        StatusCode:
          type: integer
          format: int32
        Message:
          type: string
          nullable: true
      additionalProperties: false
    TooManyRequests_Result:
      required:
        - StatusCode
      type: object
      properties:
        StatusCode:
          type: integer
          format: int32
        Message:
          type: string
          nullable: true
      additionalProperties: false
    InternalServerError_Result:
      required:
        - StatusCode
      type: object
      properties:
        StatusCode:
          type: integer
          format: int32
        Message:
          type: string
          nullable: true
      additionalProperties: false
    ServiceUnavailable_Result:
      required:
        - StatusCode
      type: object
      properties:
        StatusCode:
          type: integer
          format: int32
        Message:
          type: string
          nullable: true
      additionalProperties: false
    GatewayTimeout_Result:
      required:
        - StatusCode
      type: object
      properties:
        StatusCode:
          type: integer
          format: int32
        Message:
          type: string
          nullable: true
      additionalProperties: false

````