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

# Enable Marketplace App

> Turns the app on for the viewer (`user`) or, with `embed:enable_org` and `embed.org`, for everyone in their org (`org`), and answers the app as the viewer now sees it. Turning on an app already on changes nothing.

Answers 403 `ENABLEMENT_SCOPE_NOT_ALLOWED` for a scope the marketplace doesn't allow.

Takes the marketplace owner's user JWT for the viewer, with `embed:enable` in its `rollout.com` scopes, expiring within an hour.



## OpenAPI

````yaml /openapi/rollout.json put /embedded-apps/marketplaces/{marketplaceId}/apps/{appId}/enablements/{scope}
openapi: 3.1.2
info:
  title: Universal API Documentation
  description: Development documentation
  version: '1.0'
servers:
  - url: https://universal.rollout.com/api
security: []
paths:
  /embedded-apps/marketplaces/{marketplaceId}/apps/{appId}/enablements/{scope}:
    put:
      tags:
        - Embedded Apps
      summary: Enable Marketplace App
      description: >-
        Turns the app on for the viewer (`user`) or, with `embed:enable_org` and
        `embed.org`, for everyone in their org (`org`), and answers the app as
        the viewer now sees it. Turning on an app already on changes nothing.


        Answers 403 `ENABLEMENT_SCOPE_NOT_ALLOWED` for a scope the marketplace
        doesn't allow.


        Takes the marketplace owner's user JWT for the viewer, with
        `embed:enable` in its `rollout.com` scopes, expiring within an hour.
      operationId: putEmbedded-appsMarketplacesByMarketplaceIdAppsByAppIdEnablementsByScope
      parameters:
        - name: marketplaceId
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            description: The marketplace's id.
        - name: appId
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            description: The app's id.
        - name: scope
          in: path
          required: true
          schema:
            type: string
            enum:
              - user
              - org
            description: >-
              Who an enablement turns an app on for: `user`, the viewer alone,
              or `org`, everyone in the viewer's org.
      responses:
        '200':
          description: Response for status 200
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  name:
                    type: string
                  tagline:
                    type: string
                  description:
                    type: string
                  iconUrl:
                    description: >-
                      The app's icon on Rollout's origin, a PNG, JPEG or WebP
                      image, or null.
                    type:
                      - string
                      - 'null'
                  supportUrl:
                    description: An http(s) URL, or null.
                    type:
                      - string
                      - 'null'
                  privacyPolicyUrl:
                    description: An http(s) URL, or null.
                    type:
                      - string
                      - 'null'
                  enabled:
                    type: object
                    properties:
                      user:
                        type: boolean
                        description: Whether the viewer turned it on for themselves.
                      org:
                        type: boolean
                        description: >-
                          Whether the viewer's org has it on; false for a token
                          without `embed.org`.
                    required:
                      - user
                      - org
                required:
                  - id
                  - name
                  - tagline
                  - description
                  - iconUrl
                  - supportUrl
                  - privacyPolicyUrl
                  - enabled
        '401':
          description: Response for status 401
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                        message:
                          type: string
                      required:
                        - code
                        - message
                required:
                  - errors
        '403':
          description: Response for status 403
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                        message:
                          type: string
                      required:
                        - code
                        - message
                required:
                  - errors
        '404':
          description: Response for status 404
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                        message:
                          type: string
                      required:
                        - code
                        - message
                required:
                  - errors
      security:
        - jwt: []
components:
  securitySchemes:
    jwt:
      type: http
      scheme: bearer
      description: Consumer JWT minted by the tenant's backend

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.