diff --git a/database/migrations/2026_08_10_145347_create_api_clients_table.php b/database/migrations/2026_08_10_145347_create_api_clients_table.php
index d67931e..f9642eb 100644
--- a/database/migrations/2026_08_10_145347_create_api_clients_table.php
+++ b/database/migrations/2026_08_10_145347_create_api_clients_table.php
@@ -18,9 +18,12 @@ return new class () extends Migration
 
             $table->string('name');
             $table->string('slug')->unique();
-            $table->string('identifier')->unique();
-            $table->text('secret');
-            $table->boolean('is_active');
+            $table->string('identifier')->unique()
+                ->comment('ENCRYPTED, Unique identifier that should not change');
+            $table->text('secret')
+                ->comment('ENCRYPTED, api secret that can be regenerated');
+            $table->boolean('is_active')
+                ->comment('Defines if the client can be used in order to gain access to the system');
 
             $table->timestamp('created_at');
             $table->timestamp('updated_at');