Batch refresh access tokens for connected accounts

Administrative endpoint that refreshes authentication tokens for multiple connected accounts in parallel. This is useful for proactive token refresh to prevent authentication failures or for recovering from authentication issues across multiple connections.

Headers

x-api-keystringRequired

x-composio-admin-tokenstringRequired

Admin authentication token required for administrative operations

Request

This endpoint expects an object.

connectionIdslist of stringsRequired

List of connection identifiers that need token refresh

parallelismintegerOptional>=1<=10Defaults to 5

Controls processing speed and system load. Higher values process faster but increase load.

Response

Successfully processed refresh request with detailed results

successlist of strings

List of connections where token refresh was successful or not needed

failureslist of objects

Array of connections that failed to refresh with detailed error information

1	curl -X POST https://backend.composio.dev/api/v3/admin/auth-refresh \
2	-H "x-composio-admin-token: adm_123456789abcdef" \
3	-H "x-api-key: <apiKey>" \
4	-H "Content-Type: application/json" \
5	-d '{
6	"connectionIds": [
7	"conn_123abc",
8	"conn_456def"
9	]
10	}'

1	{
2	"success": [
3	"conn_123abc"
4	],
5	"failures": [
6	{
7	"connectionId": "conn_456def",
8	"error": "REFRESH_ERROR"
9	}
10	]
11	}

Headers

Request

Response

Errors