> ## Documentation Index > Fetch the complete documentation index at: https://docs.devmob.app.br/llms.txt > Use this file to discover all available pages before exploring further. # Update Phone > Updates phone using a RESET_PHONE OTP. ## OpenAPI ````yaml /api-reference/driver/openapi.json patch /api/v1/driver/profile/phone openapi: 3.0.0 info: title: DEVMOB Driver API description: DEVMOB API version: '1.0' contact: {} servers: [] security: [] tags: - name: Auth description: Authentication and token lifecycle - name: Invite description: Driver invitation preview and acceptance - name: Notification description: Driver inbox notifications - name: OTP description: One-time password flows - name: Profile description: Authenticated driver profile - name: Session description: Authenticated sessions - name: Storage description: Storage uploads - name: Trip description: Driver trips - name: Trip Boarding description: Ticket boarding - name: Trip Event description: Trip operational events - name: Trip Manifest description: Trip passenger manifest - name: Trip Tracking description: Driver GPS tracking paths: /api/v1/driver/profile/phone: patch: tags: - Profile summary: Update Phone description: Updates phone using a RESET_PHONE OTP. operationId: updateDriverProfilePhone parameters: - name: fields in: query required: false description: >- Comma-separated list of fields to include in the response. Supports dot notation. schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateProfilePhoneRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/Profile' '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '409': $ref: '#/components/responses/ConflictError' '422': $ref: '#/components/responses/UnprocessableEntityError' '500': $ref: '#/components/responses/InternalServerError' components: schemas: UpdateProfilePhoneRequest: type: object properties: otpId: type: string format: uuid description: OTP identifier. example: 0197aa0b-5c2c-79fd-8f62-b5f9b3c5d5cb code: type: string description: OTP code. example: '482910' phoneIso: type: string description: Phone country ISO code. example: BR phoneDdi: type: string description: Phone country calling code. example: '55' phoneNumber: type: string description: Phone number without country code. example: '11999999999' required: - otpId - code - phoneIso - phoneDdi - phoneNumber description: Update phone payload. Profile: type: object properties: userId: type: string format: uuid description: Identificador do usuário googleProviderId: type: string nullable: true description: ID do provedor Google OAuth scope: type: object properties: permissionIds: type: array items: type: string organization: type: object nullable: true properties: organizationId: type: string format: uuid name: type: string required: - organizationId - name role: type: object nullable: true properties: roleId: type: string format: uuid name: type: string required: - roleId - name required: - permissionIds - organization - role description: Escopo de organização, role e permissões name: type: string description: Nome completo email: type: string nullable: true description: Email emailVerified: type: boolean description: Email verificado avatar: type: string nullable: true description: Referência ao avatar document: type: string nullable: true description: Número do documento documentType: type: string enum: - CPF - CNPJ - RG nullable: true description: Tipo do documento birthDate: type: string format: date nullable: true description: Data de nascimento phoneIso: type: string description: Código ISO do país do telefone phoneDdi: type: string description: DDI do telefone phoneNumber: type: string description: Número do telefone phoneVerified: type: boolean description: Telefone verificado status: type: string enum: - PENDING - ACTIVE - BLOCKED description: Status da conta createdBy: type: string format: uuid nullable: true description: Usuário que criou o registro, quando aplicável createdAt: type: string format: date-time description: Data de criação updatedBy: type: string format: uuid nullable: true description: Usuário que fez a última atualização, quando aplicável updatedAt: type: string format: date-time description: Data da última atualização required: - userId - googleProviderId - scope - name - email - emailVerified - avatar - document - documentType - birthDate - phoneIso - phoneDdi - phoneNumber - phoneVerified - status - createdBy - createdAt - updatedBy - updatedAt description: >- Visão consolidada do usuário autenticado — identidade, dados de passageiro e escopo de acesso ValidationError: type: object properties: statusCode: type: integer description: HTTP status code. example: 400 message: type: string description: Error message. example: Bad Request Error errors: type: array items: type: object properties: code: type: string description: Validation code. example: invalid_type message: type: string description: Validation message. example: Required path: type: string description: Invalid field path. example: name required: - code - message - path required: - statusCode - message - errors description: Validation error response. ApiError: type: object properties: statusCode: type: integer description: HTTP status code. example: 404 error: type: string description: HTTP error name. example: Not Found message: type: string description: Machine-readable error code. example: resource.not_found required: - statusCode - error - message description: Domain error response. responses: BadRequestError: description: Validation failed. content: application/json: schema: $ref: '#/components/schemas/ValidationError' UnauthorizedError: description: Authentication required. content: application/json: schema: $ref: '#/components/schemas/ApiError' ConflictError: description: State conflict. content: application/json: schema: $ref: '#/components/schemas/ApiError' UnprocessableEntityError: description: Business rule violation. content: application/json: schema: $ref: '#/components/schemas/ApiError' InternalServerError: description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/ApiError' ````