Retrieve Settings of an Installed Extension

GET

https://mapi.storyblok.com/v1/spaces/:space_id/app_provisions/:extension_id

Retrieve settings of an extension by the numeric ID. To do so, obtain an OAuth token or a Personal Access Token.

This endpoints gives both the app and app_provision objects in the response for the specific extension.

Tip

You can find more information on how to get your OAuth token on our OAuth 2.0 Authorization Flow documentation.

Note

To generate a personal access token, you can do that from My Account → Account Settings → Personal access token.

Path parameters

• :space_id required number

  Numeric ID of a space

• :extension_id required number

  Numeric id of an extension

Response properties

• app The Extension Object

  The extension object

• app_provision The App Provision Object

  The app_provision object

Examples

cURL

curl "https://mapi.storyblok.com/v1/spaces/288868932106293/app_provisions/123123" \
  -H "Authorization: YOUR_OAUTH_TOKEN"

JS

// storyblok-js-client@>=7, node@>=18
import Storyblok from "storyblok-js-client";

const storyblok = new Storyblok({
  oauthToken: "YOUR_PERSONAL_ACCESS_TOKEN",
});

try {
  const response = await storyblok.get('spaces/288868932106293/app_provisions/123123', {})
  console.log({ response })
} catch (error) {
  console.log(error)
}

PHP

$client = new \Storyblok\ManagementClient('YOUR_OAUTH_TOKEN');

$client->get('spaces/288868932106293/app_provisions/123123')->getBody();

Java

HttpResponse<String> response = Unirest.get("https://mapi.storyblok.com/v1/spaces/288868932106293/app_provisions/123123")
  .header("Authorization", "YOUR_OAUTH_TOKEN")
  .asString();

C#

var client = new RestClient("https://mapi.storyblok.com/v1/spaces/288868932106293/app_provisions/123123");
var request = new RestRequest(Method.GET);

request.AddHeader("Authorization", "YOUR_OAUTH_TOKEN");
IRestResponse response = client.Execute(request);

Python

import requests

url = "https://mapi.storyblok.com/v1/spaces/288868932106293/app_provisions/123123"

querystring = {}

payload = ""
headers = {
  'Authorization': "YOUR_OAUTH_TOKEN"
}

response = requests.request("GET", url, data=payload, headers=headers, params=querystring)

print(response.text)

Ruby

require 'storyblok'
client = Storyblok::Client.new(oauth_token: 'YOUR_OAUTH_TOKEN')

client.get('spaces/288868932106293/app_provisions/123123')

Swift

let storyblok = URLSession(storyblok: .mapi(accessToken: .oauth("YOUR_OAUTH_TOKEN")))
let request = URLRequest(storyblok: storyblok, path: "spaces/288868932106293/app_provisions/123123")
let (data, _) = try await storyblok.data(for: request)
print(try JSONSerialization.jsonObject(with: data))

Kotlin

val client = HttpClient {
    install(Storyblok(MAPI)) {
        accessToken = OAuth("YOUR_OAUTH_TOKEN")
    }
}

val response = client.get("spaces/288868932106293/app_provisions/123123")

println(response.body<JsonElement>())