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

# List Integrations

> ListIntegrations returns all the integrations for the given Hub.

This API should not be exposed to End Users via the embedded UI since it includes integrations which have not
been published.




## OpenAPI

````yaml get /hubs/{hub_id}/integrations
openapi: 3.1.0
info:
  title: Versori Embedded API
  version: 0.0.1
  license:
    name: UNLICENSED
    identifier: UNLICENSED
  description: V1 API for managing embedded integrations
servers:
  - description: Production
    url: https://platform.versori.com/api/embedded/v1
  - description: Staging
    url: https://platform-staging.versori.com/api/embedded/v1/
  - description: Development
    url: http://localhost:8950/embedded/v1
security: []
tags:
  - name: Hubs
  - name: End Users
  - name: Connectors
  - name: Integrations
  - name: Connections
  - name: Embedded
  - name: Miscellaneous
  - name: Internal
paths:
  /hubs/{hub_id}/integrations:
    parameters:
      - $ref: '#/components/parameters/hub_id'
    get:
      tags:
        - Integrations
      summary: List Integrations
      description: >
        ListIntegrations returns all the integrations for the given Hub.


        This API should not be exposed to End Users via the embedded UI since it
        includes integrations which have not

        been published.
      operationId: ListIntegrations
      parameters:
        - $ref: '#/components/parameters/first'
        - $ref: '#/components/parameters/before'
        - $ref: '#/components/parameters/after'
        - name: search
          in: query
          description: >
            Search is a string that is used to filter the list of Integrations.
            The search string is matched against the

            name.
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListIntegrations'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  parameters:
    hub_id:
      name: hub_id
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/ULID'
    first:
      name: first
      in: query
      required: false
      schema:
        type: integer
        default: 20
    before:
      name: before
      in: query
      required: false
      schema:
        type: string
    after:
      name: after
      in: query
      required: false
      schema:
        type: string
  schemas:
    ListIntegrations:
      type: object
      properties:
        total:
          description: Total integrations for the given Hub
          type: integer
        integrations:
          type: array
          items:
            $ref: '#/components/schemas/Integration'
      required:
        - total
        - integrations
    Error:
      type: object
      properties:
        code:
          type: string
          description: Code is a machine-readable error code.
        message:
          type: string
          description: Message is a human-readable error message.
        fields:
          type: array
          items:
            $ref: '#/components/schemas/ErrorField'
          x-go-type-skip-optional-pointer: true
        details:
          type: string
          x-go-type-skip-optional-pointer: true
      required:
        - code
        - message
    ULID:
      type: string
      format: ulid
      x-go-type: ulid.ULID
      x-go-type-skip-optional-pointer: true
      x-go-type-import:
        path: versori.dev/vergo/ulid
    Integration:
      description: >
        Integration represents an embedded integration that can be activated by
        end users.
      type: object
      properties:
        id:
          type: string
          format: ulid
          x-go-type: ulid.ULID
          x-go-type-skip-optional-pointer: true
          x-go-type-import:
            path: versori.dev/vergo/ulid
          x-go-name: ID
        name:
          description: >
            Name is a short name for the integration, this is typically the name
            of the Connector being integrated to.
          type: string
        imageUrl:
          description: >
            ImageURL is a URL to an image/icon that represents the integration.
            This image is used within the 

            integration tile displayed in the embedded UI.
          type: string
          format: uri
          x-go-name: ImageURL
        screenshotUrl:
          description: >
            ScreenshotURL is a PNG image/screenshot of the integration and can
            be used in the Hub Overview screen when displaying all integrations.
          type: string
          format: uri
          x-go-name: ScreenshotURL
        description:
          description: >
            Description can be used to provide a longer description of the
            integration. This can be shown to end users

            in the embedded integration hub UI.
          type: string
        variablesSchema:
          description: >
            VariablesSchema is the JSON schema for the variables defined for
            this integration.
          type: object
          x-go-type-skip-optional-pointer: true
          x-go-type: json.RawMessage
        boardId:
          description: >
            BoardID is a reference to underlying board that configures the
            integration. 


            For more information on boards see Switchboard API.
          type: string
          format: ulid
          x-go-type: ulid.ULID
          x-go-type-skip-optional-pointer: true
          x-go-type-import:
            path: versori.dev/vergo/ulid
          x-go-name: BoardID
      required:
        - id
        - name
        - boardId
    ErrorField:
      description: ErrorField denotes a field which has an error.
      type: object
      properties:
        field:
          type: string
          description: >
            Field is the name of the field which has an error, this may be a
            path to a nested field, including array

            elements. The format of this field is of the form:
            "field1.field2[0].field3"
        message:
          type: string
          description: Message is the error message for this specific field.
      required:
        - field
        - message

````