> ## Documentation Index > Fetch the complete documentation index at: https://docs.prisme.ai/llms.txt > Use this file to discover all available pages before exploring further. # List App Instances > Get installed aps ## OpenAPI ````yaml /api-reference/swagger.yml get /v2/workspaces/{workspaceId}/apps openapi: 3.0.0 info: version: 1.0.0 title: Prisme.ai APIs description: Prisme.ai APIs specifications termsOfService: https://www.prisme.ai/mentions-legales contact: name: Prisme.ai Support Team email: support@prisme.ai url: https://www.prisme.ai license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.studio.prisme.ai description: Prisme.ai Cloud - url: https://{customDomain} description: Self-hosted Prisme.ai instance variables: customDomain: default: api.your-prisme-instance.com description: API hostname of your self-hosted Prisme.ai deployment - url: http://localhost:3001 description: Local development security: - BearerAuth: [] - OrgApiKeyAuth: [] - BearerAuth: [] OrgApiKeyAuth: [] tags: - name: API Gateway description: >- Authentication, session management, SSO providers, and user profile endpoints. - name: Prisme.ai Workspaces description: >- CRUD operations for workspaces and their resources (pages, apps, automations, imports, variables). - name: Prisme.ai Runtime description: Execute workspace automations and manage their runtime lifecycle. - name: Prisme.ai Events description: Event ingestion, delivery, and subscription filtering across the platform. - name: Organizations description: >- Manage organizations, members, roles, invites, groups, and org-level service accounts. - name: Subscriptions description: >- Manage organization subscription plans and tier assignments (SuperAdmin only). - name: Secrets description: Read and patch encrypted key-value secrets scoped to a workspace. - name: ApiKeys description: Create, list, rotate, and validate workspace-scoped API keys. - name: Permissions description: >- Share or unshare resources (workspaces, pages, …) with users via roles or fine-grained rules. - name: Monitoring description: Platform readiness checks across services (SuperAdmin only). - name: AuthProviders paths: /v2/workspaces/{workspaceId}/apps: get: tags: - Prisme.ai Workspaces summary: List App Instances description: Get installed aps operationId: listAppInstances parameters: - name: workspaceId in: path description: Workspace id required: true schema: type: string responses: '200': description: Success Response content: application/json: schema: type: array items: $ref: '#/components/schemas/DetailedAppInstance' '400': description: Bad parameters content: application/json: schema: $ref: '#/components/schemas/BadParametersError' '401': description: AuthenticationError content: application/json: schema: $ref: '#/components/schemas/AuthenticationError' '403': description: Bad permissions content: application/json: schema: $ref: '#/components/schemas/ForbiddenError' '404': description: Object not found content: application/json: schema: $ref: '#/components/schemas/ObjectNotFoundError' components: schemas: DetailedAppInstance: type: object required: - appSlug - slug - automations - blocks - events additionalProperties: false properties: appSlug: type: string description: App unique id appName: $ref: '#/components/schemas/LocalizedText' appVersion: type: string description: Defaults to the latest known app version slug: type: string description: >- Unique & human readable id across current workspace's appInstances, which will be used to call this app automations disabled: type: boolean description: If disabled, this appInstance will be ignored during execution labels: type: array items: type: string pattern: ^[0-9A-Za-z._:-]{2,60}$ updatedAt: type: string createdAt: type: string updatedBy: type: string createdBy: type: string checksum: type: string photo: type: string automations: $ref: '#/components/schemas/AppAutomations' events: $ref: '#/components/schemas/ProcessedEvents' blocks: $ref: '#/components/schemas/AppBlocks' BadParametersError: type: object properties: error: type: string example: BadParameters message: type: string details: {} AuthenticationError: type: object properties: error: type: string example: AuthenticationError message: type: string example: Unauthenticated ForbiddenError: type: object properties: error: type: string example: ForbiddenError message: type: string example: Forbidden ObjectNotFoundError: type: object properties: error: type: string example: ObjectNotFound message: type: string LocalizedText: oneOf: - type: object additionalProperties: type: string example: fr: Bonjour en: Hello - type: string example: Bonjour AppAutomations: type: array items: type: object required: - slug - name - arguments properties: slug: type: string name: $ref: '#/components/schemas/LocalizedText' description: $ref: '#/components/schemas/LocalizedText' arguments: additionalProperties: $ref: '#/components/schemas/TypedArgument' ProcessedEvents: type: object properties: emit: type: array items: type: string listen: type: array items: type: string autocomplete: type: array items: type: object required: - event properties: event: type: string example: prismeaiMessenger.message autocomplete: $ref: '#/components/schemas/EmitAutocomplete' AppBlocks: type: array items: type: object required: - slug properties: slug: type: string url: type: string edit: $ref: '#/components/schemas/TypedArgument' name: $ref: '#/components/schemas/LocalizedText' description: $ref: '#/components/schemas/LocalizedText' arguments: additionalProperties: $ref: '#/components/schemas/TypedArgument' TypedArgument: type: object properties: type: type: string enum: - string - number - object - array - boolean - localized:string - localized:number - localized:boolean format: type: string properties: additionalProperties: type: object description: >- Recursive reference to `TypedArgument` — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer. title: $ref: '#/components/schemas/LocalizedText' description: $ref: '#/components/schemas/LocalizedText' items: type: object description: >- Recursive reference to `TypedArgument` — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer. ui:widget: type: string ui:options: type: object example: type: string title: en: User ID description: en: The unique identifier of the user secret: type: boolean event: type: boolean EmitAutocomplete: type: object additionalProperties: type: object properties: from: type: string path: type: string template: type: string securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT OrgApiKeyAuth: type: apiKey in: header name: x-prismeai-api-key ````