chore(backend): Add API keys get, delete and update methods (#7400)

Author: wobsoriano

.changeset/early-clouds-shake.md

@@ -0,0 +1,18 @@
+---
+"@clerk/backend": minor
+---
+
+Added API keys `get`, `delete` and `update` methods.
+
+Usage:
+
+```ts
+await clerkClient.apiKeys.get('api_key_id')
+
+await clerkClient.apiKeys.update({
+  apiKeyId: 'api_key_id',
+  scopes: ['scope1', 'scope2']
+})
+
+await clerkClient.apiKeys.delete('api_key_id')
+```

integration/testUtils/usersService.ts

@@ -62,7 +62,7 @@ export type FakeOrganization = {
 export type FakeAPIKey = {
   apiKey: APIKey;
   secret: string;
-  revoke: () => Promise<APIKey>;
+  revoke: (reason?: string | null) => Promise<APIKey>;
 };
 
 export type UserService = {
@@ -208,7 +208,8 @@ export const createUserService = (clerkClient: ClerkClient) => {
       return {
         apiKey,
         secret: apiKey.secret ?? '',
-        revoke: () => clerkClient.apiKeys.revoke({ apiKeyId: apiKey.id, revocationReason: 'For testing purposes' }),
+        revoke: (reason?: string | null) =>
+          clerkClient.apiKeys.revoke({ apiKeyId: apiKey.id, revocationReason: reason }),
       } satisfies FakeAPIKey;
     },
     passwordCompromised: async (userId: string) => {

integration/tests/machine-auth/api-keys.test.ts

@@ -65,7 +65,7 @@ test.describe('Next.js API key auth within clerkMiddleware() @machine', () => {
   });
 
   test.afterAll(async () => {
-    await fakeAPIKey.revoke();
+    await fakeAPIKey.revoke('Testing purposes within clerkMiddleware()');
     await fakeUser.deleteIfExists();
     await app.teardown();
   });