List Marketplace Apps
curl --request GET \
--url https://universal.rollout.com/api/embedded-apps/marketplaces/{marketplaceId}/apps \
--header 'Authorization: Bearer <token>'import requests
url = "https://universal.rollout.com/api/embedded-apps/marketplaces/{marketplaceId}/apps"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://universal.rollout.com/api/embedded-apps/marketplaces/{marketplaceId}/apps', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://universal.rollout.com/api/embedded-apps/marketplaces/{marketplaceId}/apps",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://universal.rollout.com/api/embedded-apps/marketplaces/{marketplaceId}/apps"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://universal.rollout.com/api/embedded-apps/marketplaces/{marketplaceId}/apps")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://universal.rollout.com/api/embedded-apps/marketplaces/{marketplaceId}/apps")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"canEnable": [
"user"
],
"canDisable": [
"user"
],
"apps": [
{
"id": "<string>",
"name": "<string>",
"tagline": "<string>",
"description": "<string>",
"iconUrl": "<string>",
"supportUrl": "<string>",
"privacyPolicyUrl": "<string>",
"enabled": {
"user": true,
"org": true
}
}
]
}{
"errors": [
{
"code": "<string>",
"message": "<string>"
}
]
}{
"errors": [
{
"code": "<string>",
"message": "<string>"
}
]
}{
"errors": [
{
"code": "<string>",
"message": "<string>"
}
]
}Embedded Apps
List Marketplace Apps
Lists the apps approved in the marketplace, by name, each with whether it’s on for the viewer and for their org, and the scopes the viewer may turn apps on and off for.
Takes the marketplace owner’s user JWT for the viewer, with embed:enable in its rollout.com scopes, expiring within an hour.
GET
/
embedded-apps
/
marketplaces
/
{marketplaceId}
/
apps
List Marketplace Apps
curl --request GET \
--url https://universal.rollout.com/api/embedded-apps/marketplaces/{marketplaceId}/apps \
--header 'Authorization: Bearer <token>'import requests
url = "https://universal.rollout.com/api/embedded-apps/marketplaces/{marketplaceId}/apps"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://universal.rollout.com/api/embedded-apps/marketplaces/{marketplaceId}/apps', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://universal.rollout.com/api/embedded-apps/marketplaces/{marketplaceId}/apps",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://universal.rollout.com/api/embedded-apps/marketplaces/{marketplaceId}/apps"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://universal.rollout.com/api/embedded-apps/marketplaces/{marketplaceId}/apps")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://universal.rollout.com/api/embedded-apps/marketplaces/{marketplaceId}/apps")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"canEnable": [
"user"
],
"canDisable": [
"user"
],
"apps": [
{
"id": "<string>",
"name": "<string>",
"tagline": "<string>",
"description": "<string>",
"iconUrl": "<string>",
"supportUrl": "<string>",
"privacyPolicyUrl": "<string>",
"enabled": {
"user": true,
"org": true
}
}
]
}{
"errors": [
{
"code": "<string>",
"message": "<string>"
}
]
}{
"errors": [
{
"code": "<string>",
"message": "<string>"
}
]
}{
"errors": [
{
"code": "<string>",
"message": "<string>"
}
]
}Query Parameters
Response
Response for status 200
The scopes the viewer may turn apps off for: those the token grants, whatever the marketplace allows. One missing from canEnable is a scope the marketplace stopped allowing, whose apps stay on until turned off.
Who an enablement turns an app on for: user, the viewer alone, or org, everyone in the viewer's org.
Available options:
user, org