> ## Documentation Index
> Fetch the complete documentation index at: https://www.klavis.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.



## OpenAPI

````yaml get /mcp-server/instance/{instanceId}/auth
openapi: 3.1.0
info:
  title: Klavis AI (https://www.klavis.ai)
  description: Klavis AI - Open Source MCP Integrations for AI Applications
  version: 0.1.0
servers:
  - url: https://api.klavis.ai
    description: US Production server
  - url: https://api.eu.klavis.ai
    description: EU Production server
security: []
paths:
  /mcp-server/instance/{instanceId}/auth:
    get:
      tags:
        - mcp-server
      summary: Get Instance Auth
      description: >-
        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.
      operationId: getInstanceAuthData
      parameters:
        - name: instanceId
          in: path
          required: true
          schema:
            type: string
            format: uuid
            description: >-
              The ID of the connection integration instance to get auth data
              for.
            title: Instanceid
          description: The ID of the connection integration instance to get auth data for.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAuthDataResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    GetAuthDataResponse:
      properties:
        success:
          type: boolean
          title: Success
          description: Whether the request was successful
        authData:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: GetAuthDataResponseAuthData
          description: >-
            Complete authentication data including access token, refresh token,
            scope, expiration, and platform-specific data
        error:
          anyOf:
            - type: string
            - type: 'null'
          title: Error
          description: Error message if the request failed
      type: object
      required:
        - success
      title: GetAuthDataResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      description: Your Klavis AI API key.
      scheme: bearer
      x-fern-bearer:
        name: api_key

````