Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 19:45 UTC
fix(core): expose auth config list search filters (#3647)
This PR: - exposes `search` and `showDisabled` on `authConfigs.list()` - forwards those filters to the generated `@composio/client` as `search` and `show_disabled` - documents the filters and adds a core changeset - covers forwarding in `AuthConfigs` tests
Alberto Schiabel committed
Jun 24, 2026 at 19:14 UTC
552859adc2d4af574adc9b45217b91304c72497b
5 files changed
+37
-7
.changeset/auth-config-list-search.md
new
+5
@@ -0,0 +1,5 @@
1
+---
2
+'@composio/core': patch
3
+---
4
+
5
+Expose `search` and `showDisabled` filters on `authConfigs.list()`.
ts/docs/api/auth-configs.md
+16
-7
@@ -16,6 +16,12 @@ const allAuthConfigs = await composio.authConfigs.list();
16
const githubAuthConfigs = await composio.authConfigs.list({
17
toolkit: 'github',
18
});
19
+
20
+// Search auth configs by name or id and include disabled configs
21
+const searchedAuthConfigs = await composio.authConfigs.list({
22
+ search: 'github',
23
+ showDisabled: true,
24
+});
25
```
26
27
**Parameters:**
@@ -81,8 +87,8 @@ const updatedAuthConfig = await composio.authConfigs.update('auth_config_123', {
87
client_secret: 'new_client_secret',
88
},
89
toolAccessConfig: {
84
- toolsAvailableForExecution: ['GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER']
85
- }
90
+ toolsAvailableForExecution: ['GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER'],
91
+ },
92
});
93
94
// Update a default auth config with new scopes
@@ -90,8 +96,8 @@ const updatedDefaultAuth = await composio.authConfigs.update('auth_config_456',
96
type: 'default',
97
scopes: 'read:user,repo',
98
toolAccessConfig: {
93
- toolsAvailableForExecution: ['GITHUB_GET_A_REPOSITORY', 'GITHUB_LIST_REPOSITORIES_FOR_A_USER']
94
- }
99
+ toolsAvailableForExecution: ['GITHUB_GET_A_REPOSITORY', 'GITHUB_LIST_REPOSITORIES_FOR_A_USER'],
100
+ },
101
});
102
```
103
@@ -104,7 +110,8 @@ const updatedDefaultAuth = await composio.authConfigs.update('auth_config_456',
110
111
**Returns:** Promise<AuthConfigUpdateResponse> - The updated auth config
112
107
-**Throws:**
113
+**Throws:**
114
+
115
- ValidationError if the update parameters are invalid
116
- ComposioAuthConfigNotFoundError if the auth config cannot be found
117
@@ -133,8 +140,10 @@ await composio.authConfigs.delete('auth_config_123');
140
interface AuthConfigListParams {
141
cursor?: string; // Pagination cursor
142
limit?: number; // Limit the number of results
136
- orderBy?: string; // Order by field
143
+ search?: string; // Search auth configs by name or id
144
+ showDisabled?: boolean; // Include disabled auth configs
145
toolkit?: string; // Filter by toolkit slug
146
+ isComposioManaged?: boolean; // Filter by Composio-managed auth configs
147
}
148
```
149
@@ -184,7 +193,7 @@ interface AuthConfigCreateParams {
193
194
```typescript
195
// Discriminated union type for updating auth configs
187
-type AuthConfigUpdateParams =
196
+type AuthConfigUpdateParams =
197
| {
198
type: 'custom';
199
credentials: Record<string, string | number | boolean | unknown>;
ts/packages/core/src/models/AuthConfigs.ts
+8
@@ -72,6 +72,12 @@ export class AuthConfigs {
72
* toolkit: 'github'
73
* });
74
*
75
+ * // Search auth configs by name or id
76
+ * const searchedConfigs = await composio.authConfigs.list({
77
+ * search: 'github',
78
+ * showDisabled: true
79
+ * });
80
+ *
81
* // List Composio-managed auth configs
82
* const managedConfigs = await composio.authConfigs.list({
83
* isComposioManaged: true
@@ -84,6 +90,8 @@ export class AuthConfigs {
90
cursor: parsedQuery?.cursor,
91
is_composio_managed: parsedQuery?.isComposioManaged,
92
limit: parsedQuery?.limit,
93
+ search: parsedQuery?.search,
94
+ show_disabled: parsedQuery?.showDisabled,
95
toolkit_slug: parsedQuery?.toolkit,
96
});
97
return transformAuthConfigListResponse(result);
ts/packages/core/src/types/authConfigs.types.ts
+2
@@ -125,6 +125,8 @@ export const AuthConfigListParamsSchema = z.object({
125
cursor: z.string().optional(),
126
isComposioManaged: z.boolean().optional(),
127
limit: z.number().optional(),
128
+ search: z.string().optional(),
129
+ showDisabled: z.boolean().optional(),
130
toolkit: z.string().optional(),
131
});
132
export type AuthConfigListParams = z.infer<typeof AuthConfigListParamsSchema>;
ts/packages/core/test/AuthConfigs/authConfigs.test.ts
+6
@@ -162,6 +162,8 @@ describe('AuthConfigs', () => {
162
cursor: undefined,
163
is_composio_managed: undefined,
164
limit: undefined,
165
+ search: undefined,
166
+ show_disabled: undefined,
167
toolkit_slug: undefined,
168
});
169
@@ -179,6 +181,8 @@ describe('AuthConfigs', () => {
181
cursor: 'cursor_123',
182
isComposioManaged: true,
183
limit: 10,
184
+ search: 'github config',
185
+ showDisabled: true,
186
toolkit: 'github',
187
};
188
@@ -188,6 +192,8 @@ describe('AuthConfigs', () => {
192
cursor: 'cursor_123',
193
is_composio_managed: true,
194
limit: 10,
195
+ search: 'github config',
196
+ show_disabled: true,
197
toolkit_slug: 'github',
198
});
199