diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..9f11b75
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+.idea/
diff --git a/src/app/Packages/Features/CommandUseCases/UseCase/User/UpdateUserUseCase.php b/src/app/Packages/Features/CommandUseCases/UseCase/User/UpdateUserUseCase.php
new file mode 100644
index 0000000..a99e045
--- /dev/null
+++ b/src/app/Packages/Features/CommandUseCases/UseCase/User/UpdateUserUseCase.php
@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Packages\Features\CommandUseCases\UseCase\User;
+
+use App\Packages\Domains\Interface\UserRepositroyInterface;
+use App\Packages\Domains\User\Factory\UserEntityFactory;
+use App\Packages\Features\CommandUseCases\UseCommand\User\UpdateUserCommand;
+use App\Packages\Features\QueryUseCases\Dto\User\UserDto;
+
+final class UpdateUserUseCase
+{
+    public function __construct(
+        private readonly UserRepositroyInterface $userRepository,
+    ) {}
+
+    public function handle(UpdateUserCommand $command): UserDto
+    {
+        $entity = UserEntityFactory::build([
+            'id'                      => $command->id,
+            'first_name'              => $command->firstName,
+            'last_name'               => $command->lastName,
+            'email'                   => $command->email,
+            'age_range'               => $command->ageRange,
+            'subscription_tier'       => $command->subscriptionTier,
+            'subscription_expires_at' => $command->subscriptionExpiresAt,
+        ]);
+
+        return $this->userRepository->updateUser($entity);
+    }
+}
\ No newline at end of file
diff --git a/src/app/Packages/Features/CommandUseCases/UseCommand/User/UpdateUserCommand.php b/src/app/Packages/Features/CommandUseCases/UseCommand/User/UpdateUserCommand.php
new file mode 100644
index 0000000..4176a5c
--- /dev/null
+++ b/src/app/Packages/Features/CommandUseCases/UseCommand/User/UpdateUserCommand.php
@@ -0,0 +1,46 @@
+<?php
+
+namespace App\Packages\Features\CommandUseCases\UseCommand\User;
+
+use InvalidArgumentException;
+
+final class UpdateUserCommand
+{
+    private const REQUIRED_KEYS = [
+        'id',
+        'first_name',
+        'last_name',
+        'email',
+        'age_range',
+        'subscription_tier',
+    ];
+
+    private function __construct(
+        public readonly int     $id,
+        public readonly string  $firstName,
+        public readonly string  $lastName,
+        public readonly string  $email,
+        public readonly string  $ageRange,
+        public readonly string  $subscriptionTier,
+        public readonly ?string $subscriptionExpiresAt,
+    ) {}
+
+    public static function fromArray(array $data): self
+    {
+        foreach (self::REQUIRED_KEYS as $key) {
+            if (!array_key_exists($key, $data)) {
+                throw new InvalidArgumentException("Missing required key: {$key}");
+            }
+        }
+
+        return new self(
+            id:                    (int) $data['id'],
+            firstName:             $data['first_name'],
+            lastName:              $data['last_name'],
+            email:                 $data['email'],
+            ageRange:              $data['age_range'],
+            subscriptionTier:      $data['subscription_tier'],
+            subscriptionExpiresAt: $data['subscription_expires_at'] ?? null,
+        );
+    }
+}
\ No newline at end of file
diff --git a/src/app/Packages/Features/Controller/UserController.php b/src/app/Packages/Features/Controller/UserController.php
index b16b67f..9917562 100644
--- a/src/app/Packages/Features/Controller/UserController.php
+++ b/src/app/Packages/Features/Controller/UserController.php
@@ -3,9 +3,11 @@
 namespace App\Packages\Features\Controller;
 
 use App\Http\Controllers\Controller;
-use App\Packages\Features\CommandUseCases\Factory\ViewModel\UserViewModelFactory;
+use App\Packages\Features\QueryUseCases\Factory\ViewModel\UserViewModelFactory;
 use App\Packages\Features\CommandUseCases\UseCase\User\CreateUserUseCase;
+use App\Packages\Features\CommandUseCases\UseCase\User\UpdateUserUseCase;
 use App\Packages\Features\CommandUseCases\UseCommand\User\CreateUserCommand;
+use App\Packages\Features\CommandUseCases\UseCommand\User\UpdateUserCommand;
 use App\Packages\Features\QueryUseCases\UseCase\User\GetUserByIdUseCase;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
@@ -44,6 +46,41 @@ public function getUserById(
         }
     }
 
+    public function updateUser(
+        Request $request,
+        UpdateUserUseCase $useCase,
+    ): JsonResponse {
+        try {
+            $command = UpdateUserCommand::fromArray(array_merge(
+                $request->all(),
+                ['id' => $request->route('id')],
+            ));
+            $dto = $useCase->handle($command);
+
+            return response()->json([
+                'status' => 'success',
+                'data'   => UserViewModelFactory::build($dto)->toArray(),
+            ], 200);
+        } catch (\Exception $exception) {
+            if ($exception->getMessage() === 'User not found.') {
+                return response()->json([
+                    'status'  => 'error',
+                    'message' => 'User not found.',
+                ], 404);
+            }
+
+            Log::error('Failed to update user', [
+                'message' => $exception->getMessage(),
+                'trace'   => $exception->getTraceAsString(),
+            ]);
+
+            return response()->json([
+                'status'  => 'error',
+                'message' => 'Internal Server Error',
+            ], 500);
+        }
+    }
+
     public function createUser(
         Request $request,
         CreateUserUseCase $useCase,
diff --git a/src/app/Packages/Features/CommandUseCases/Factory/ViewModel/UserViewModelFactory.php b/src/app/Packages/Features/QueryUseCases/Factory/ViewModel/UserViewModelFactory.php
similarity index 60%
rename from src/app/Packages/Features/CommandUseCases/Factory/ViewModel/UserViewModelFactory.php
rename to src/app/Packages/Features/QueryUseCases/Factory/ViewModel/UserViewModelFactory.php
index a4e2a3d..519e15b 100644
--- a/src/app/Packages/Features/CommandUseCases/Factory/ViewModel/UserViewModelFactory.php
+++ b/src/app/Packages/Features/QueryUseCases/Factory/ViewModel/UserViewModelFactory.php
@@ -1,8 +1,8 @@
 <?php
 
-namespace App\Packages\Features\CommandUseCases\Factory\ViewModel;
+namespace App\Packages\Features\QueryUseCases\Factory\ViewModel;
 
-use App\Packages\Features\CommandUseCases\ViewModel\User\UserViewModel;
+use App\Packages\Features\QueryUseCases\ViewModel\User\UserViewModel;
 use App\Packages\Features\QueryUseCases\Dto\User\UserDto;
 
 class UserViewModelFactory
diff --git a/src/app/Packages/Features/Tests/CommandUseCases/UserViewModelFactoryTest.php b/src/app/Packages/Features/QueryUseCases/Tests/ViewModel/UserViewModelFactoryTest.php
similarity index 78%
rename from src/app/Packages/Features/Tests/CommandUseCases/UserViewModelFactoryTest.php
rename to src/app/Packages/Features/QueryUseCases/Tests/ViewModel/UserViewModelFactoryTest.php
index 32938a5..13074c3 100644
--- a/src/app/Packages/Features/Tests/CommandUseCases/UserViewModelFactoryTest.php
+++ b/src/app/Packages/Features/QueryUseCases/Tests/ViewModel/UserViewModelFactoryTest.php
@@ -1,9 +1,9 @@
 <?php
 
-namespace App\Packages\Features\Tests\CommandUseCases;
+namespace App\Packages\Features\QueryUseCases\Tests\ViewModel;
 
-use App\Packages\Features\CommandUseCases\Factory\ViewModel\UserViewModelFactory;
-use App\Packages\Features\CommandUseCases\ViewModel\User\UserViewModel;
+use App\Packages\Features\QueryUseCases\Factory\ViewModel\UserViewModelFactory;
+use App\Packages\Features\QueryUseCases\ViewModel\User\UserViewModel;
 use App\Packages\Features\QueryUseCases\Dto\User\UserDto;
 use Faker\Factory as FakerFactory;
 use PHPUnit\Framework\TestCase;
diff --git a/src/app/Packages/Features/Tests/CommandUseCases/UserViewModelTest.php b/src/app/Packages/Features/QueryUseCases/Tests/ViewModel/UserViewModelTest.php
similarity index 93%
rename from src/app/Packages/Features/Tests/CommandUseCases/UserViewModelTest.php
rename to src/app/Packages/Features/QueryUseCases/Tests/ViewModel/UserViewModelTest.php
index ffde5ce..007cd58 100644
--- a/src/app/Packages/Features/Tests/CommandUseCases/UserViewModelTest.php
+++ b/src/app/Packages/Features/QueryUseCases/Tests/ViewModel/UserViewModelTest.php
@@ -1,8 +1,8 @@
 <?php
 
-namespace App\Packages\Features\Tests\CommandUseCases;
+namespace App\Packages\Features\QueryUseCases\Tests\ViewModel;
 
-use App\Packages\Features\CommandUseCases\ViewModel\User\UserViewModel;
+use App\Packages\Features\QueryUseCases\ViewModel\User\UserViewModel;
 use App\Packages\Features\QueryUseCases\Dto\User\UserDto;
 use Faker\Factory as FakerFactory;
 use PHPUnit\Framework\TestCase;
diff --git a/src/app/Packages/Features/CommandUseCases/ViewModel/User/UserViewModel.php b/src/app/Packages/Features/QueryUseCases/ViewModel/User/UserViewModel.php
similarity index 91%
rename from src/app/Packages/Features/CommandUseCases/ViewModel/User/UserViewModel.php
rename to src/app/Packages/Features/QueryUseCases/ViewModel/User/UserViewModel.php
index 96ca814..17402a1 100644
--- a/src/app/Packages/Features/CommandUseCases/ViewModel/User/UserViewModel.php
+++ b/src/app/Packages/Features/QueryUseCases/ViewModel/User/UserViewModel.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace App\Packages\Features\CommandUseCases\ViewModel\User;
+namespace App\Packages\Features\QueryUseCases\ViewModel\User;
 
 use App\Packages\Features\QueryUseCases\Dto\User\UserDto;
 
diff --git a/src/app/Packages/Features/Tests/CommandUseCases/UpdateUserCommandTest.php b/src/app/Packages/Features/Tests/CommandUseCases/UpdateUserCommandTest.php
new file mode 100644
index 0000000..0e4b4ad
--- /dev/null
+++ b/src/app/Packages/Features/Tests/CommandUseCases/UpdateUserCommandTest.php
@@ -0,0 +1,72 @@
+<?php
+
+namespace App\Packages\Features\Tests\CommandUseCases;
+
+use App\Packages\Features\CommandUseCases\UseCommand\User\UpdateUserCommand;
+use Faker\Factory as FakerFactory;
+use InvalidArgumentException;
+use PHPUnit\Framework\TestCase;
+
+class UpdateUserCommandTest extends TestCase
+{
+    private function validData(array $overrides = []): array
+    {
+        $faker = FakerFactory::create();
+
+        return array_merge([
+            'id'                => $faker->unique()->randomNumber(5),
+            'first_name'        => $faker->firstName(),
+            'last_name'         => $faker->lastName(),
+            'email'             => $faker->unique()->safeEmail(),
+            'age_range'         => $faker->randomElement(['teens', '20s', '30s', '40s', '50s', '60plus']),
+            'subscription_tier' => $faker->randomElement(['free', 'premium']),
+        ], $overrides);
+    }
+
+    public function test_fromArray_creates_command_with_valid_data(): void
+    {
+        $data    = $this->validData();
+        $command = UpdateUserCommand::fromArray($data);
+
+        $this->assertSame((int) $data['id'], $command->id);
+        $this->assertSame($data['first_name'], $command->firstName);
+        $this->assertSame($data['last_name'], $command->lastName);
+        $this->assertSame($data['email'], $command->email);
+        $this->assertSame($data['age_range'], $command->ageRange);
+        $this->assertSame($data['subscription_tier'], $command->subscriptionTier);
+        $this->assertNull($command->subscriptionExpiresAt);
+    }
+
+    public function test_fromArray_sets_subscription_expires_at_when_provided(): void
+    {
+        $command = UpdateUserCommand::fromArray($this->validData([
+            'subscription_expires_at' => '2027-01-01 00:00:00',
+        ]));
+
+        $this->assertSame('2027-01-01 00:00:00', $command->subscriptionExpiresAt);
+    }
+
+    #[\PHPUnit\Framework\Attributes\DataProvider('missingKeyProvider')]
+    public function test_fromArray_throws_when_required_key_is_missing(string $missingKey): void
+    {
+        $data = $this->validData();
+        unset($data[$missingKey]);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Missing required key: {$missingKey}");
+
+        UpdateUserCommand::fromArray($data);
+    }
+
+    public static function missingKeyProvider(): array
+    {
+        return [
+            ['id'],
+            ['first_name'],
+            ['last_name'],
+            ['email'],
+            ['age_range'],
+            ['subscription_tier'],
+        ];
+    }
+}
diff --git a/src/app/Packages/Features/Tests/CommandUseCases/UpdateUserUseCaseTest.php b/src/app/Packages/Features/Tests/CommandUseCases/UpdateUserUseCaseTest.php
new file mode 100644
index 0000000..1c205db
--- /dev/null
+++ b/src/app/Packages/Features/Tests/CommandUseCases/UpdateUserUseCaseTest.php
@@ -0,0 +1,68 @@
+<?php
+
+namespace App\Packages\Features\Tests\CommandUseCases;
+
+use App\Packages\Domains\Interface\UserRepositroyInterface;
+use App\Packages\Domains\User\UserEntity;
+use App\Packages\Features\CommandUseCases\UseCase\User\UpdateUserUseCase;
+use App\Packages\Features\CommandUseCases\UseCommand\User\UpdateUserCommand;
+use App\Packages\Features\QueryUseCases\Dto\User\UserDto;
+use Faker\Factory as FakerFactory;
+use Mockery;
+use Mockery\MockInterface;
+use PHPUnit\Framework\TestCase;
+
+class UpdateUserUseCaseTest extends TestCase
+{
+    protected function tearDown(): void
+    {
+        Mockery::close();
+        parent::tearDown();
+    }
+
+    private function buildCommand(): UpdateUserCommand
+    {
+        $faker = FakerFactory::create();
+
+        return UpdateUserCommand::fromArray([
+            'id'                => $faker->unique()->randomNumber(5),
+            'first_name'        => $faker->firstName(),
+            'last_name'         => $faker->lastName(),
+            'email'             => $faker->unique()->safeEmail(),
+            'age_range'         => $faker->randomElement(['teens', '20s', '30s', '40s', '50s', '60plus']),
+            'subscription_tier' => 'free',
+        ]);
+    }
+
+    private function buildDto(): UserDto
+    {
+        $faker = FakerFactory::create();
+
+        return new UserDto(
+            id:                    $faker->unique()->randomNumber(5),
+            firstName:             $faker->firstName(),
+            lastName:              $faker->lastName(),
+            email:                 $faker->unique()->safeEmail(),
+            ageRange:              'teens',
+            subscriptionTier:      'free',
+            subscriptionExpiresAt: null,
+        );
+    }
+
+    public function test_handle_passes_entity_to_repository_and_returns_dto(): void
+    {
+        $command = $this->buildCommand();
+        $dto     = $this->buildDto();
+
+        /** @var UserRepositroyInterface|MockInterface $repository */
+        $repository = Mockery::mock(UserRepositroyInterface::class);
+        $repository->shouldReceive('updateUser')
+            ->once()
+            ->with(Mockery::type(UserEntity::class))
+            ->andReturn($dto);
+
+        $result = (new UpdateUserUseCase($repository))->handle($command);
+
+        $this->assertSame($dto, $result);
+    }
+}
\ No newline at end of file
diff --git a/src/app/Packages/Features/Tests/UpdateUserTest.php b/src/app/Packages/Features/Tests/UpdateUserTest.php
new file mode 100644
index 0000000..b375ab5
--- /dev/null
+++ b/src/app/Packages/Features/Tests/UpdateUserTest.php
@@ -0,0 +1,109 @@
+<?php
+
+namespace App\Packages\Features\Tests;
+
+use App\Models\User;
+use Faker\Factory as FakerFactory;
+use Illuminate\Support\Facades\DB;
+use Tests\TestCase;
+
+class UpdateUserTest extends TestCase
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+        $this->truncate();
+    }
+
+    protected function tearDown(): void
+    {
+        $this->truncate();
+        parent::tearDown();
+    }
+
+    private function truncate(): void
+    {
+        if (env('APP_ENV') === 'testing') {
+            DB::connection('mysql')->statement('SET FOREIGN_KEY_CHECKS=0;');
+            User::truncate();
+            DB::connection('mysql')->statement('SET FOREIGN_KEY_CHECKS=1;');
+        }
+    }
+
+    private function seedUser(array $overrides = []): User
+    {
+        $faker = FakerFactory::create();
+
+        return User::create(array_merge([
+            'first_name'              => $faker->firstName(),
+            'last_name'               => $faker->lastName(),
+            'email'                   => $faker->unique()->safeEmail(),
+            'password'                => bcrypt('password'),
+            'age_range'               => 'teens',
+            'subscription_tier'       => 'free',
+            'subscription_expires_at' => null,
+        ], $overrides));
+    }
+
+    private function validPayload(array $overrides = []): array
+    {
+        $faker = FakerFactory::create();
+
+        return array_merge([
+            'first_name'        => $faker->firstName(),
+            'last_name'         => $faker->lastName(),
+            'email'             => $faker->unique()->safeEmail(),
+            'age_range'         => '30s',
+            'subscription_tier' => 'premium',
+        ], $overrides);
+    }
+
+    public function test_update_user_returns_200_with_updated_data(): void
+    {
+        $user = $this->seedUser();
+
+        $payload  = $this->validPayload(['email' => 'updated@example.com']);
+        $response = $this->patchJson("/api/v1/users/{$user->id}", $payload);
+
+        $response->assertStatus(200)
+            ->assertJsonStructure([
+                'status',
+                'data' => [
+                    'id',
+                    'first_name',
+                    'last_name',
+                    'email',
+                    'age_range',
+                    'subscription_tier',
+                    'subscription_expires_at',
+                ],
+            ])
+            ->assertJsonFragment([
+                'status' => 'success',
+                'email'  => 'updated@example.com',
+            ]);
+    }
+
+    public function test_update_user_returns_404_when_user_not_found(): void
+    {
+        $response = $this->patchJson('/api/v1/users/999999', $this->validPayload());
+
+        $response->assertStatus(404)
+            ->assertJsonFragment([
+                'status'  => 'error',
+                'message' => 'User not found.',
+            ]);
+    }
+
+    public function test_update_user_returns_500_when_required_key_is_missing(): void
+    {
+        $user    = $this->seedUser();
+        $payload = $this->validPayload();
+        unset($payload['email']);
+
+        $response = $this->patchJson("/api/v1/users/{$user->id}", $payload);
+
+        $response->assertStatus(500)
+            ->assertJsonFragment(['status' => 'error']);
+    }
+}
diff --git a/src/routes/api.php b/src/routes/api.php
index 7f5dcb8..a3d59bd 100644
--- a/src/routes/api.php
+++ b/src/routes/api.php
@@ -11,5 +11,6 @@
     Route::get('/heritages/{id}', [WorldHeritageController::class, 'getWorldHeritageById']);
 
     Route::get('/users/{id}', [UserController::class, 'getUserById']);
+    Route::patch('/users/{id}', [UserController::class, 'updateUser']);
     Route::post('/user/create', [UserController::class, 'createUser']);
 });
\ No newline at end of file