Update Customization

Updates the JavaScript and CSS Customization settings of an App.

This API updates the pre-live settings.
After using this API, use the Deploy App Settings API to deploy the settings to the live App.
Method PUT
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
Authentication Password Authentication
Content-Type application/json

Permissions

  • App Management Permissions are needed.
  • API Tokens cannot be used with this API.

Request Parameters

Parameters that are ignored will not be updated.

Parameter Value Required Description
app Integer or String Yes The App ID.
desktop Object   An object containing data of JavaScript and CSS files for the desktop.
desktop.css Array   An array listing data of CSS files.
desktop.css[].file Object   An Object containing data of CSS file uploads.
Specify, if "FILE" is selected for desktop.css[].type .
desktop.css[].file.fileKey String   The fileKey of the CSS file.
To attach a file, specify the fileKey that is responded when using the Upload File API.
To keep the current CSS files that are attached to the App, specify the fileKeys that are responded when using the Get Customization API for the Pre-live settings.
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.
Specify, if "URL" is selected for desktop.css[].type .
desktop.js Array   An array listing data of JavaScript files.
desktop.js[].file Object   An Object containing data of an uploaded JavaScript file.
Specify, if "FILE" is selected for desktop.js[].type .
desktop.js[].file.fileKey String   The fileKey of the JavaScript file.
To attach a file, specify the fileKey that is responded when using the Upload File API.
To keep the current JavaScript files that are attached to the App, specify the fileKeys that are responded when using the Get Customization API for the Pre-live settings.
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.
Specify, if "URL" is selected for desktop.js[].type .
mobile Object   An object containing data of JavaScript files for the mobile.
mobile.js Array   An array listing data of JavaScript files.
mobile.js[].file Object   An Object containing data of JavaScript file uploads.
Specify, if "FILE" is selected for mobile.js[].type .
mobile.js[].file.fileKey String   The fileKey of the JavaScript file.
To attach a file, specify the fileKey that is responded when using the Upload File API.
To keep the current JavaScript files that are attached to the App, specify the fileKeys that are responded when using the Get Customization API for the Pre-live settings.
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.
Specify, if "URL" is selected for mobile.js[].type .
revision Integer or String   Specify the revision number of the settings that will be deployed.
The request will fail if the revision number is not the latest revision.
The revision will not be checked if this parameter is ignored, or -1 is specified.
scope String   The scope of customization
  • ALL: Affect all users
  • ADMIN: Affect only App administrators
  • NONE: Disable

Sample Request

JavaScript (using kintone REST API Request)

XMLHttpRequest

Response Parameters

Parameter Type Description
revision String The revision number of the App settings.

Sample Response

Was this article helpful?
0 out of 0 found this helpful
Comments
Please sign in to leave a comment.