Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
feat(ts/core): support redirect_url in connectedAccounts
jkomyno committed
Jan 20, 2026 at 21:05 UTC
99e10a99cbcfaff89571bc1365ea18fc436e857c
3 files changed
+108
-4
ts/packages/core/src/models/ConnectedAccounts.ts
+24
-2
@@ -8,6 +8,7 @@
8
import ComposioClient from '@composio/client';
9
import {
10
ConnectedAccountDeleteResponse,
11
+ ConnectedAccountRefreshParams,
12
ConnectedAccountRefreshResponse,
13
ConnectedAccountUpdateStatusParams,
14
ConnectedAccountUpdateStatusResponse,
@@ -23,6 +24,8 @@ import {
24
CreateConnectedAccountLinkOptions,
25
CreateConnectedAccountLinkOptionsSchema,
26
ConnectedAccountStatuses,
27
+ ConnectedAccountRefreshOptions,
28
+ ConnectedAccountRefreshOptionsSchema,
29
} from '../types/connectedAccounts.types';
30
import { ConnectionRequest } from '../types/connectionRequest.types';
31
import { createConnectionRequest } from './ConnectionRequest';
@@ -370,8 +373,27 @@ export class ConnectedAccounts {
373
* const refreshedAccount = await composio.connectedAccounts.refresh('conn_abc123');
374
* ```
375
*/
373
- async refresh(nanoid: string): Promise<ConnectedAccountRefreshResponse> {
374
- return this.client.connectedAccounts.refresh(nanoid);
376
+ async refresh(
377
+ nanoid: string,
378
+ options?: ConnectedAccountRefreshOptions
379
+ ): Promise<ConnectedAccountRefreshResponse> {
380
+ let params: ConnectedAccountRefreshParams | undefined = undefined;
381
+
382
+ if (options) {
383
+ const parsedOptions = ConnectedAccountRefreshOptionsSchema.safeParse(options);
384
+ if (!parsedOptions.success) {
385
+ throw new ValidationError('Failed to parse connected account refresh options', {
386
+ cause: parsedOptions.error,
387
+ });
388
+ }
389
+
390
+ params = {
391
+ body_redirect_url: parsedOptions.data.redirectUrl,
392
+ validate_credentials: parsedOptions.data.validateCredentials,
393
+ };
394
+ }
395
+
396
+ return this.client.connectedAccounts.refresh(nanoid, params);
397
}
398
399
/**
ts/packages/core/src/types/connectedAccounts.types.ts
+6
@@ -191,3 +191,9 @@ export const CreateConnectedAccountLinkResponseSchema = z.object({
191
export type CreateConnectedAccountLinkResponse = z.infer<
192
typeof CreateConnectedAccountLinkResponseSchema
193
>;
194
+
195
+export const ConnectedAccountRefreshOptionsSchema = z.object({
196
+ redirectUrl: z.string().optional(),
197
+ validateCredentials: z.boolean().optional(),
198
+});
199
+export type ConnectedAccountRefreshOptions = z.infer<typeof ConnectedAccountRefreshOptionsSchema>;
ts/packages/core/test/connectedAccounts/connectedAccounts.test.ts
+78
-2
@@ -441,7 +441,7 @@ describe('ConnectedAccounts', () => {
441
});
442
443
describe('refresh', () => {
444
- it('should refresh a connected account by nanoid', async () => {
444
+ it('should refresh a connected account by nanoid without options', async () => {
445
const nanoid = 'conn_123';
446
const mockResponse = { id: nanoid, refreshed: true };
447
@@ -449,7 +449,83 @@ describe('ConnectedAccounts', () => {
449
450
const result = await connectedAccounts.refresh(nanoid);
451
452
- expect(extendedMockClient.connectedAccounts.refresh).toHaveBeenCalledWith(nanoid);
452
+ expect(extendedMockClient.connectedAccounts.refresh).toHaveBeenCalledWith(nanoid, undefined);
453
+ expect(result).toEqual(mockResponse);
454
+ });
455
+
456
+ it('should refresh a connected account with redirectUrl option', async () => {
457
+ const nanoid = 'conn_123';
458
+ const redirectUrl = 'https://example.com/oauth/callback';
459
+ const mockResponse = { id: nanoid, refreshed: true };
460
+
461
+ extendedMockClient.connectedAccounts.refresh.mockResolvedValueOnce(mockResponse);
462
+
463
+ const result = await connectedAccounts.refresh(nanoid, { redirectUrl });
464
+
465
+ expect(extendedMockClient.connectedAccounts.refresh).toHaveBeenCalledWith(nanoid, {
466
+ body_redirect_url: redirectUrl,
467
+ validate_credentials: undefined,
468
+ });
469
+ expect(result).toEqual(mockResponse);
470
+ });
471
+
472
+ it('should refresh a connected account with validateCredentials option', async () => {
473
+ const nanoid = 'conn_123';
474
+ const mockResponse = { id: nanoid, refreshed: true };
475
+
476
+ extendedMockClient.connectedAccounts.refresh.mockResolvedValueOnce(mockResponse);
477
+
478
+ const result = await connectedAccounts.refresh(nanoid, { validateCredentials: true });
479
+
480
+ expect(extendedMockClient.connectedAccounts.refresh).toHaveBeenCalledWith(nanoid, {
481
+ body_redirect_url: undefined,
482
+ validate_credentials: true,
483
+ });
484
+ expect(result).toEqual(mockResponse);
485
+ });
486
+
487
+ it('should refresh a connected account with both options', async () => {
488
+ const nanoid = 'conn_123';
489
+ const options = {
490
+ redirectUrl: 'https://example.com/callback',
491
+ validateCredentials: false,
492
+ };
493
+ const mockResponse = { id: nanoid, refreshed: true };
494
+
495
+ extendedMockClient.connectedAccounts.refresh.mockResolvedValueOnce(mockResponse);
496
+
497
+ const result = await connectedAccounts.refresh(nanoid, options);
498
+
499
+ expect(extendedMockClient.connectedAccounts.refresh).toHaveBeenCalledWith(nanoid, {
500
+ body_redirect_url: options.redirectUrl,
501
+ validate_credentials: options.validateCredentials,
502
+ });
503
+ expect(result).toEqual(mockResponse);
504
+ });
505
+
506
+ it('should throw ValidationError for invalid options', async () => {
507
+ const nanoid = 'conn_123';
508
+ const invalidOptions = { redirectUrl: 123 };
509
+
510
+ await expect(connectedAccounts.refresh(nanoid, invalidOptions as any)).rejects.toThrow(
511
+ 'Failed to parse connected account refresh options'
512
+ );
513
+
514
+ expect(extendedMockClient.connectedAccounts.refresh).not.toHaveBeenCalled();
515
+ });
516
+
517
+ it('should handle empty options object gracefully', async () => {
518
+ const nanoid = 'conn_123';
519
+ const mockResponse = { id: nanoid, refreshed: true };
520
+
521
+ extendedMockClient.connectedAccounts.refresh.mockResolvedValueOnce(mockResponse);
522
+
523
+ const result = await connectedAccounts.refresh(nanoid, {});
524
+
525
+ expect(extendedMockClient.connectedAccounts.refresh).toHaveBeenCalledWith(nanoid, {
526
+ body_redirect_url: undefined,
527
+ validate_credentials: undefined,
528
+ });
529
expect(result).toEqual(mockResponse);
530
});
531
});