> ## 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. # Update roaming settings of a number > Enable or disable international roaming on a provisioned phone number. Use this to allow a subscriber's device to register on partner networks outside their home country, or to disable roaming to prevent unexpected usage charges. ## OpenAPI ````yaml /api-reference/openapi.json post /v1.0/numbers/roaming/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/roaming/update: post: tags: - Numbers summary: Update roaming settings of a number description: >- Enable or disable international roaming on a provisioned phone number. Use this to allow a subscriber's device to register on partner networks outside their home country, or to disable roaming to prevent unexpected usage charges. requestBody: description: Update_Roaming_Request object content: application/json: schema: $ref: '#/components/schemas/Update_Roaming_Request' text/json: schema: $ref: '#/components/schemas/Update_Roaming_Request' application/*+json: schema: $ref: '#/components/schemas/Update_Roaming_Request' responses: '200': description: Success content: text/plain: schema: $ref: '#/components/schemas/Update_Roaming_Result' application/json: schema: $ref: '#/components/schemas/Update_Roaming_Result' text/json: schema: $ref: '#/components/schemas/Update_Roaming_Result' '400': description: Bad Request content: text/plain: schema: type: string application/json: schema: type: string text/json: schema: type: string '401': description: Unauthorized content: text/plain: schema: $ref: '#/components/schemas/Unauthorized_Result' application/json: schema: $ref: '#/components/schemas/Unauthorized_Result' text/json: schema: $ref: '#/components/schemas/Unauthorized_Result' '403': description: Forbidden content: text/plain: schema: type: string application/json: schema: type: string text/json: schema: type: string '404': description: Not Found content: text/plain: schema: type: string application/json: schema: type: string text/json: schema: type: string '405': description: Method Not Allowed content: text/plain: schema: $ref: '#/components/schemas/MethodNotAllowed_Result' application/json: schema: $ref: '#/components/schemas/MethodNotAllowed_Result' 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' 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' 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' text/json: schema: $ref: '#/components/schemas/InternalServerError_Result' '503': description: Service is unavailable content: text/plain: schema: $ref: '#/components/schemas/ServiceUnavailable_Result' application/json: schema: $ref: '#/components/schemas/ServiceUnavailable_Result' 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' text/json: schema: $ref: '#/components/schemas/GatewayTimeout_Result' x-codeSamples: - lang: JSON source: |- { "PhoneNumber": "+12345678901", "EnableRoaming": true, "AccountId": "AID-1234567" } - lang: cURL source: |- curl -X POST https://api.telegent.com/v1.0/numbers/roaming/update \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "PhoneNumber": "+12345678901", "EnableRoaming": true, "AccountId": "AID-1234567" }' components: schemas: Update_Roaming_Request: required: - EnableRoaming - PhoneNumber type: object properties: PhoneNumber: minLength: 1 type: string description: >- The phone number to update, in E.164 format (e.g. `+12345678901`). Required. EnableRoaming: type: boolean description: >- Set to `true` to enable international roaming on the number, or `false` to disable it. Required. AccountId: type: string nullable: true description: >- Optional account identifier (`AID-` prefix) used to scope the request to a specific account when your Bearer token has access to multiple accounts. additionalProperties: false Update_Roaming_Result: type: object properties: PhoneNumber: type: string nullable: true Roaming: type: string nullable: true Status: type: string nullable: true StatusMessage: type: string nullable: true AccountId: 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 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 ````