COcomposiohq
Connected Accounts
Authentication

Re-initiate authentication for a connected account (DEPRECATED)

Changed on

DEPRECATED: This endpoint re-initiates the authorization flow for a connected account — a developer-triggered reconnection (e.g. to recover a connection whose credentials expired or became invalid), returning a new OAuth redirect URL where applicable. It does NOT perform background credential auto-refresh; the "refresh" name was misleading, which is why the endpoint is deprecated and may be removed in a future release.

post/api/v3/connected_accounts/{nanoid}/refresh

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3/connected_accounts/{nanoid}/refresh
  • Auth
    API key in header x-api-key

Path parameters

nanoidstring connectedAccountId required

The unique identifier of the connected account

Query parameters

redirect_urlstring uri

Request body

redirect_urlstring uri

Response

Successfully refreshed the connected account authentication. For OAuth flows, a new redirect URL is provided.

idstring required

The unique identifier of the connected account

status'INITIALIZING' | 'INITIATED' | 'ACTIVE' | 'FAILED' | 'EXPIRED' | 'INACTIVE' | 'REVOKED' required

The current status of the connected account (e.g., active, pending, failed)

redirect_urlstring nullable required

The URL to which the user should be redirected to complete the authentication process (null for auth schemes that do not require redirection)

Example response

{
  "id": "ca_1a2b3c4d5e6f",
  "status": "ACTIVE",
  "redirect_url": "https://app.example.com/oauth/callback"
}

Changes

  • 0d00d8bf42bfRevision changes
    • warning

      removed the request property

  • 73b05c1e5119Revision changes
    • warning

      added the new REVOKED enum value to the response property for the response status

    • info

      the endpoint scheme security CookieAuth was removed from the API

    • info

      the endpoint scheme security UserApiKeyAuth was removed from the API

    • info

      endpoint deprecated