Get Instance Auth

Retrieves the auth data for a specific integration instance that the API key owner controls. Includes access token, refresh token, and other authentication data.

This endpoint includes proper ownership verification to ensure users can only access authentication data for integration instances they own. It also handles token refresh if needed.

GET /mcp-server/instance/{instanceId}/auth

Get Instance Auth

cURL

curl --request GET \
  --url https://api.klavis.ai/mcp-server/instance/{instanceId}/auth \
  --header 'Authorization: Bearer <token>'

200

{
  "success": true,
  "authData": {},
  "error": "<string>"
}

Authorizations

Authorization · string · header · required

Your Klavis AI API key.

Path Parameters

instanceId · string<uuid> · required

The ID of the connection integration instance to get auth data for.

Response

200

application/json

Successful Response

success · boolean · required

Whether the request was successful

authData · GetAuthDataResponseAuthData · object

Complete authentication data including access token, refresh token, scope, expiration, and platform-specific data

error · string | null

Error message if the request failed