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

# List app install connections

> Returns the app connections (per-client, per-group, or per-company embeds and links)
attached to a manual app install. Optionally filter the result by company or client.
The install must be a manual-type app; core and marketplace installs do not support
connections.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/installs/{installId}/connections
openapi: 3.0.0
info:
  contact: {}
  title: Assembly API
  version: 0.0.1
servers:
  - url: https://api.assembly.com
security: []
paths:
  /v1/installs/{installId}/connections:
    get:
      tags:
        - Installs
      summary: List app install connections
      description: >-
        Returns the app connections (per-client, per-group, or per-company
        embeds and links)

        attached to a manual app install. Optionally filter the result by
        company or client.

        The install must be a manual-type app; core and marketplace installs do
        not support

        connections.
      operationId: list-app-connections
      parameters:
        - description: Unique identifier of the manual app install
          in: path
          name: installId
          required: true
          schema:
            type: string
        - description: Filter connections to a single company
          in: query
          name: companyId
          schema:
            type: string
        - description: Filter connections to a single client
          in: query
          name: clientId
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/appConnection.AppConnection'
                type: array
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: >-
            App install is not a manual app or its connections could not be
            loaded
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: >-
            Missing or invalid API key, or caller is not permitted to list
            connections
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: App install not found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Unexpected server error
      security:
        - APIKeyHeader: []
components:
  schemas:
    appConnection.AppConnection:
      properties:
        clientIds:
          description: external facing root fields
          items:
            type: string
          nullable: true
          type: array
        companyId:
          nullable: true
          type: string
        content:
          type: string
        createdAt:
          type: string
        creatorId:
          type: string
        data:
          type: string
        domainMetadata:
          $ref: '#/components/schemas/appConnection.AppConnectionFields'
        id:
          type: string
        identityId:
          type: string
        installId:
          type: string
        membershipType:
          $ref: '#/components/schemas/appConnection.AppConnectionMembershipType'
        object:
          type: string
        previousAttributes:
          additionalProperties: true
          type: object
        ref:
          type: string
        type:
          $ref: '#/components/schemas/appConnection.AppConnectionType'
        updatedAt:
          type: string
      type: object
    dispatcher.Error:
      properties:
        code:
          type: string
        data: {}
        message:
          type: string
      type: object
    appConnection.AppConnectionFields:
      properties:
        autoSizeEmbed:
          type: boolean
        companyId:
          type: string
        embedCode:
          type: string
        embedLink:
          type: string
        embedlyData:
          $ref: '#/components/schemas/embedly.OEmbedResponse'
        extensionConfigId:
          type: string
        memberIDs:
          additionalProperties:
            type: boolean
          type: object
      type: object
    appConnection.AppConnectionMembershipType:
      enum:
        - individual
        - group
        - company
      type: string
      x-enum-varnames:
        - Individual
        - Group
        - Company
    appConnection.AppConnectionType:
      enum:
        - embed
        - link
      type: string
      x-enum-varnames:
        - AppConnectionEmbed
        - AppConnectionLink
    embedly.OEmbedResponse:
      properties:
        author_name:
          type: string
        author_url:
          type: string
        cache_age:
          type: integer
        description:
          type: string
        height:
          type: integer
        html:
          type: string
        provider_name:
          type: string
        provider_url:
          type: string
        thumbnail_height:
          type: integer
        thumbnail_url:
          type: string
        thumbnail_width:
          type: integer
        title:
          type: string
        type:
          type: string
        url:
          type: string
        version:
          type: string
        width:
          type: integer
      type: object
  securitySchemes:
    APIKeyHeader:
      in: header
      name: X-API-KEY
      type: apiKey

````