Get Customization

Gets the JavaScript and CSS Customization settings of an App.

MethodGET
URLhttps://{subdomain}.kintone.com/k/v1/app/customize.json
URL(guest space)https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/app/customize.json
Authentication Password Authentication, Session Authentication
Content-Typeapplication/json (not needed if specifying the query with a query string)

Contents

Pre-live settings

Apps may hold pre-live settings that have not yet been deployed to the live app.
Access the pre-live settings with the below URL.

URL https://{subdomain}.kintone.com/k/v1/preview/app/customize.json
URL(guest space) https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/preview/app/customize.json

Permissions

  • Permission to manage the app is needed when obtaining data of live apps.
  • Permission to manage the app is needed when obtaining data of pre-live settings.
  • API Tokens cannot be used with this API.

Request Parameters

Parameter Value Required Description
app Integer or String Yes The app ID.

Sample Request

JavaScript (using Kintone REST API Request)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
var body = {
  'app': 1
};

kintone.api(kintone.api.url('/k/v1/app/customize.json', true), 'GET', body, function(resp) {
  // success
  console.log(resp);
}, function(error) {
  // error
  console.log(error);
});

XMLHttpRequest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
var url = 'https://{subdomain}.kintone.com/k/v1/app/customize.json?app=1';

var xhr = new XMLHttpRequest();
xhr.open('GET', url);
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
xhr.onload = function() {
  if (xhr.status === 200) {
    // success
    console.log(JSON.parse(xhr.responseText));
  } else {
    // error
    console.log(JSON.parse(xhr.responseText));
  }
};
xhr.send();

Response Parameters

Parameter Type Description
desktop Object An object containing data of JavaScript and CSS files for the desktop.
desktop.css Array An array listing data of CSS files for desktop.
desktop.css[].file Object An Object containing data of an uploaded CSS file.
desktop.css[].file.contentType String The MIME type of the uploaded CSS file.
desktop.css[].file.fileKey String The fileKey of the uploaded CSS file.
desktop.css[].file.name String The file name of the uploaded CSS file.
desktop.css[].file.size String The byte size of the uploaded CSS file.
desktop.css[].type String The end-point type of the CSS file:
  • URL: the CSS file is specified with a URL.
  • FILE: the CSS file is uploaded to the app.
desktop.css[].url String The URL of the CSS file.
desktop.js Array An array listing data of JavaScript files.
desktop.js[].file Object An Object containing data of an uploaded JavaScript file.
desktop.js[].file.contentType String The MIME type of the uploaded JavaScript file.
desktop.js[].file.fileKey String The fileKey of the uploaded JavaScript file.
desktop.js[].file.name String The file name of the uploaded JavaScript file.
desktop.js[].file.size String The byte size of the uploaded JavaScript file.
desktop.js[].type String The end-point type of the JavaScript file:
  • URL: the JavaScript file is specified with a URL.
  • FILE: the JavaScript file is uploaded to the app.
desktop.js[].url String The URL of the JavaScript file.
mobile Object An object containing data of JavaScript and CSS files for the mobile.
mobile.css Array An array listing data of CSS files for mobile.
mobile.css[].file Object An Object containing data of an uploaded CSS file.
mobile.css[].file.contentType String The MIME type of the uploaded CSS file.
mobile.css[].file.fileKey String The fileKey of the uploaded CSS file.
mobile.css[].file.name String The file name of the uploaded CSS file.
mobile.css[].file.size String The byte size of the uploaded CSS file.
mobile.css[].type String The end-point type of the CSS file:
  • URL: the CSS file is specified with a URL.
  • FILE: the CSS file is uploaded to the app.
mobile.css[].url String The URL of the CSS file.
mobile.js Array An array listing data of JavaScript files.
mobile.js[].file Object An Object containing data of an uploaded JavaScript file.
mobile.js[].file.contentType String The MIME type of the uploaded JavaScript file.
mobile.js[].file.fileKey String The fileKey of the uploaded JavaScript file.
mobile.js[].file.name String The file name of the uploaded JavaScript file.
mobile.js[].file.size String The byte size of the uploaded JavaScript file.
mobile.js[].type String The end-point type of the JavaScript file:
  • URL: the JavaScript file is specified with a URL.
  • FILE: the JavaScript file is uploaded to the app.
mobile.js[].url String The URL of the JavaScript file.
revision String The revision number of the app settings.
scope String The scope of customization
  • ALL: Affect all users
  • ADMIN: Affect only app administrators
  • NONE: Disable

Sample Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
{
  "scope": "ALL",
  "desktop": {
    "js": [
      {
        "type": "FILE",
        "file": {
          "fileKey": "2019112507490370F72008A0044AF7A7F1F2ED183D2B27209",
          "name": "Desktop_Script_from_FileUpload.js",
          "contentType": "text/javascript",
          "size": "1364"
        }
      },
      {
        "type": "URL",
        "url": "https://www.example.com/Desktop_Script_from_Link.js"
      }
    ],
    "css": [
      {
        "type": "FILE",
        "file": {
          "fileKey": "201911250749038FE3743EA9A543E185E31AC8900B6A12106",
          "name": "desktop_StyleSheet.css",
          "contentType": "text/css",
          "size": "14"
        }
      }
    ]
  },
  "mobile": {
    "js": [
      {
        "type": "FILE",
        "file": {
          "fileKey": "2019112507490302B0656C293345CF8AE8E79C285381FC101",
          "name": "mobile_Script.js",
          "contentType": "text/javascript",
          "size": "24"
        }
      }
    ],
    "css": [
      {
        "type": "FILE",
        "file": {
          "fileKey": "2019112507490329C6BB8EA0F34B4480D265F086FEB3E9183",
          "name": "mobile_StyleSheet.css",
          "contentType": "text/css",
          "size": "17"
        }
      }
    ]
  },
  "revision": "15"
}