Skip to content

App

Gets general information of an App, including the name, description, related Space, creator and updater information.

  • Permissions to view the App is needed.
  • API Tokens cannot be used with this API.

Constructor

Parameters

Name Type Required Description
params Object (conditional) Required for nodejs
Constructor params.
params.connection Connection (conditional) The connection module of this SDK. If initializing in browser environment on kintone, this parameter can be ommited to use session authentication.

Sample code

Init app sample Javascript 
  (function(kintoneJSSDK) {
      'use strict';
      // with connection
      // Define Authentication object
      var kintoneAuth = new kintoneJSSDK.Auth();
      var paramsAuth = {
          username: 'YOUR_USER_NAME',
          password: 'YOUR_PASSWORD'
      };
      kintoneAuth.setPasswordAuth(paramsAuth);

      var paramsConnection = {
          domain: 'YOUR_DOMAIN',
          auth: kintoneAuth
      };
      var connection = new kintoneJSSDK.Connection(paramsConnection);

      // with connection
      var kintoneApp = new kintoneJSSDK.App({connection});

      // without connection, module will use session authentication of kintone
      var kintoneApp = new kintoneJSSDK.App();
  }(window.kintoneJSSDK));
Nodejs 
  const kintone = require('@kintone/kintone-js-sdk');

  const kintoneAuth = new kintone.Auth();
  const paramsAuth = {
      username: 'YOUR_USER_NAME',
      password: 'YOUR_PASSWORD'
  };
  kintoneAuth.setPasswordAuth(paramsAuth);

  const paramsConnection = {
      domain: 'YOUR_DOMAIN',
      auth: kintoneAuth
  };
  const connection = new kintone.Connection(paramsConnection);
  const kintoneApp = new kintone.App({connection});

Methods

getApp(params)

Get single app

Parameters

Name Type Required Description
params Object yes Get app params.
params.id Integer yes The kintone app ID

Return

Promise

Sample code

Get app sample Javascript 

  var id = YOUR_APP_ID;
  kintoneApp.getApp({id}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const id = YOUR_APP_ID;
  kintoneApp.getApp({id}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

getApps(params)

Get multiple apps

Parameters

Name Type Required Description
params Object (optional) Get apps params.
params.offset Integer (optional) The offset off data result
params.limit Integer (optional) The limit number of result

Return

Promise

Sample code

Get apps sample Javascript 

  var limit = YOUR_LIMIT_NUMBER;
  var offset = YOUR_OFFSET_NUMBER;
  kintoneApp.getApps({offset, limit}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const limit = YOUR_LIMIT_NUMBER;
  const offset = YOUR_OFFSET_NUMBER;
  kintoneApp.getApps({offset, limit}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

getAppsByIDs(params)

Get multiple apps by list of ids

Parameters

Name Type Required Description
params Object yes Get apps by ids params.
params.ids Array<Integer> (optional) The array of app ids
params.offset Integer (optional) The offset off data result
params.limit Integer (optional) The limit number of result

Return

Promise

Sample code

Get apps sample Javascript 

  var ids = [YOUR_APP_ID_1, YOUR_APP_ID_2, YOUR_APP_ID_n];
  var limit = YOUR_LIMIT_NUMBER;
  var offset = YOUR_OFFSET_NUMBER;
  kintoneApp.getAppsByIDs({ids, offset, limit}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const ids = [YOUR_APP_ID_1, YOUR_APP_ID_2, YOUR_APP_ID_n];
  const limit = YOUR_LIMIT_NUMBER;
  const offset = YOUR_OFFSET_NUMBER;
  kintoneApp.getAppsByIDs({ids, offset, limit}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

getAppsByCodes(params)

Get multiple apps by a list of codes name

Parameters

Name Type Required Description
params Object yes Get apps by codes params.
params.codes Array<String> (optional) The array of app codes
params.offset Integer (optional) The offset off data result
params.limit Integer (optional) The limit number of result

Return

Promise

Sample code

Get apps sample Javascript 

  var codes = ['YOUR_APP_CODE_1', 'YOUR_APP_CODE_2'];
  var limit = YOUR_LIMIT_NUMBER;
  var offset = YOUR_OFFSET_NUMBER;
  kintoneApp.getAppsByCodes({codes, offset, limit}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const codes = ['YOUR_APP_CODE_1', 'YOUR_APP_CODE_2'];
  const limit = YOUR_LIMIT_NUMBER;
  const offset = YOUR_OFFSET_NUMBER;
  kintoneApp.getAppsByCodes({codes, offset, limit}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

getAppsByName(params)

Get multiple apps by name

Parameters

Name Type Required Description
params Object yes Get apps by name params.
params.name String (optional) The app name
params.offset Integer (optional) The offset off data result
params.limit Integer (optional) The limit number of result

Return

Promise

Sample code

Get apps sample Javascript 

  var name = 'YOUR_APP_NAME';
  var limit = YOUR_LIMIT_NUMBER;
  var offset = YOUR_OFFSET_NUMBER;
  kintoneApp.getAppsByName({name, offset, limit}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const name = 'YOUR_APP_NAME';
  const limit = YOUR_LIMIT_NUMBER;
  const offset = YOUR_OFFSET_NUMBER;
  kintoneApp.getAppsByName({name, offset, limit}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

getAppsBySpaceIDs(params)

Get multiple apps by list of space's ids

Parameters

Name Type Required Description
params Object yes Get apps by space ids params.
params.spaceIds Array<Integer> (optional) The array of space ids
params.offset Integer (optional) The offset off data result
params.limit Integer (optional) The limit number of result

Return

Promise

Sample code

Get apps sample Javascript 

  var spaceIds = [];
  var limit = YOUR_LIMIT_NUMBER;
  var offset = YOUR_OFFSET_NUMBER;
  kintoneApp.getAppsBySpaceIDs({spaceIds, offset, limit}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const spaceIds = [];
  const limit = YOUR_LIMIT_NUMBER;
  const offset = YOUR_OFFSET_NUMBER;
  kintoneApp.getAppsBySpaceIDs({spaceIds, offset, limit}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

addPreviewApp(params)

Creates a preview App.

Warning

  • After using this method, use the deployAppSettings to deploy the settings to the live App.

Parameters

Name Type Required Description
params Object yes Params to add preview app.
params.name String yes The App name. The maximum length is 64 characters.
params.space Integer (optional) The Space ID of where the App will be created.
params.thread Integer (optional) The Thread ID of the thread in the Space where the App will be created. It is recommended to ignore this parameter so that Apps are created in the default thread. There is currently no helpful reason to create Apps in threads other than the default thread, as there are no visual representations in kintone of Apps being related to threads. There are only visual representations of Apps being related to Spaces.

Return

Promise

Sample code

Add preview App sample Javascript 

  var name = 'YOUR_APP_NAME';
  var space = YOUR_APP_SPACE_ID;
  var thread = YOUR_THREAD_ID_OF_SPACE;
  kintoneApp.addPreviewApp({name, space, thread}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const name = 'YOUR_APP_NAME';
  const space = YOUR_APP_SPACE_ID;
  const thread = YOUR_THREAD_ID_OF_SPACE;
  kintoneApp.addPreviewApp({name, space, thread}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

deployAppSettings(params)

Updates the settings of a pre-live App to the live App.

Parameters

Name Type Required Description
params Object yes Params to deploy app settings.
params.apps Array<JSONObject> yes The list of preview apps.
params.revert Boolean (optional) Specify "true" to cancel all changes made to the pre-live settings. The pre-live settings will be reverted back to the current settings of the live app.

Return

Promise

Sample code

Deploy app settings sample Javascript 

  var apps = [
    {
      revision: YOUR_REVISION,
      app: YOUR_APP_ID
    }
  // Another app preview here
  ];
  var revert = false;
  kintoneApp.deployAppSettings({apps, revert}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const apps = [
      {
        revision: YOUR_REVISION,
        app: YOUR_APP_ID
      }
      // Another app preview here
  ];
  const revert = false;
  kintoneApp.deployAppSettings({apps, revert}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

getAppDeployStatus(params)

Gets the deployment status of the App settings for multiple Apps.

Parameters

Name Type Required Description
params Object yes Get app deploy status params.
params.apps Array<Integer> yes The list of Apps to check the deploy statuses of. The Maximum limit is 300. If Apps in Guest Spaces are specified, all Apps specified in the request must belong to that Guest Space.

Return

Promise

Sample code

Get app deploy status sample Javascript 

  var apps = [
    YOUR_APP_ID
  // Another app id here
  ];
  kintoneApp.getAppDeployStatus({apps}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const apps = [
    YOUR_APP_ID
    // Another app id here
  ];
  kintoneApp.getAppDeployStatus({apps}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

getViews(params)

Gets the View settings of a an App.

Parameters

Name Type Required Description
params Object yes Get views params.
params.app Integer yes The app ID
params.lang String (optional) The language code. Support:
  • DEFAULT: Default language setting of system
  • JA: Japanese language setting
  • ZH: Chinese language setting
  • EN: English language setting
params.isPreview Boolean (optional) Get the views with a pre-live settings.

Return

Promise

Sample code

Get views sample Javascript 

  var app = YOUR_APP_ID;
  var lang = 'LANGUAGE_CODE'; // Ex: JA
  kintoneApp.getViews({app, lang}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

  // Get a pre-live (preview) views
  var previewApp = YOUR_APP_ID;
  var previewLang = 'LANGUAGE_CODE'; // Ex: JA
  var isPreview = true;
  kintoneApp.getViews({app: previewApp, lang: previewLang, isPreview}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const app = YOUR_APP_ID;
  const lang = 'LANGUAGE_CODE'; // Ex: JA
  kintoneApp.getViews({app, lang}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

  // Get a pre-live (preview) views
  const previewApp = YOUR_APP_ID;
  const previewLang = 'LANGUAGE_CODE'; // Ex: JA
  const isPreview = true;
  kintoneApp.getViews({app: previewApp, lang: previewLang, isPreview}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

updateViews(params)

Get field of form in kintone app

Parameters

Name Type Required Description
params Object yes Params to update views.
params.app Integer yes The app ID
params.views JSONObject yes An object of data of Views. About the format, please look the sample below or reference at the end of this page
params.revision Integer (optional) Specify the revision number of the settings that will be deployed.

Return

Promise

Sample code

Update views sample Javascript 

  var app = YOUR_APP_ID;
  var views = {
    'YOUR_VIEW_NAME': {
      'index': 0,
      'type': 'YOUR_VIEW_TYPE', // Default: 'LIST', 'CALENDAR', 'CUSTOM'
      'name': 'YOUR_VIEW_NAME',
      'fields': [
        'YOUR_FIELD_CODE'
        // Another field code here
      ],
      'filterCond': 'YOUR_QUERY',
      'sort': 'YOUR_SORT'
    }
    // Another view here
  };
  var revision = 'YOUR_SETTINGS_REVISION';

  kintoneApp.updateViews({app, views, revision}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const app = YOUR_APP_ID;
  const views = {
      "YOUR_VIEW_NAME": {
        "index": 0,
        "type": "YOUR_VIEW_TYPE", // Default: 'LIST', 'CALENDAR', 'CUSTOM'
        "name": "YOUR_VIEW_NAME",
        "fields": [
          "YOUR_FIELD_CODE"
          // Another field code here
        ],
        "filterCond": "YOUR_QUERY",
        "sort": "YOUR_SORT"      
      }
      // Another view here
  }; 
  const revision = 'YOUR_SETTINGS_REVISION';

  kintoneApp.updateViews({app, views, revision}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

getGeneralSettings(params)

Gets the description, name, icon, revision and color theme of an App.

Parameters

Name Type Required Description
params Object yes Get general settings params.
params.app Integer yes The app ID
params.lang String (optional) The language code. Support:
  • DEFAULT: Default language setting of system
  • JA: English language setting
  • ZH: Chinese language setting
  • EN: English language setting
params.isPreview Boolean (optional) Get the general with a pre-live settings.

Return

Promise

Sample code

Get general settings sample Javascript 

  var app = YOUR_APP_ID;
  var lang = 'LANGUAGE_CODE'; // Ex: JA
  kintoneApp.getGeneralSettings({app, lang}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

  // Get a pre-live (preview) general settings
  var app = YOUR_APP_ID;
  var lang = 'LANGUAGE_CODE'; // Ex: JA
  var isPreview = true;
  kintoneApp.getGeneralSettings({app, lang, isPreview}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const app = YOUR_APP_ID;
  const lang = 'LANGUAGE_CODE'; // Ex: JA
  kintoneApp.getGeneralSettings({app, lang}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

  // Get a pre-live (preview) general settings
  const app = YOUR_APP_ID;
  const lang = 'LANGUAGE_CODE'; // Ex: JA
  const isPreview = true;
  kintoneApp.getGeneralSettings({app, lang, isPreview}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

updateGeneralSettings(params)

Update the description, name, icon, revision and color theme of an App.

Parameters

Name Type Required Description
params Object yes Params to update general settings.
params.app Integer yes The app ID
params.name String (Conditional) Name of an App.
params.description String (Conditional) The description of an App.
params.icon Icon (Conditional) The icon of an App.
params.theme String (Conditional) Color theme of an App.
params.revision Integer (optional) Specify the revision number of the settings that will be deployed.

Return

Promise

Sample code

Update general settings sample Javascript 

  var params= {
    app: YOUR_APP_ID,
    name: 'YOUR_APP_NAME',
    description: 'YOUR_COOL_DESCRIPTION',
    icon: {
      type: 'YOUR_ICON_TYPE', // specified: FILE, PRESET
      key: 'YOUR_ICON_KEY'
    },
    theme: 'YOUR_THEME', // specified: WHITE, RED, BLUE, GREEN, YELLOW, BLACK
    revision: 'YOUR_SETTINGS_REVISION'
  };

  kintoneApp.updateGeneralSettings(params).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  var params= {
      app: YOUR_APP_ID,
      name: 'YOUR_APP_NAME',
      description: 'YOUR_COOL_DESCRIPTION',
      icon: {
        type: 'YOUR_ICON_TYPE', // specified: FILE, PRESET
        key: 'YOUR_ICON_KEY'
      },
      theme: 'YOUR_THEME', // specified: WHITE, RED, BLUE, GREEN, YELLOW, BLACK
      revision: 'YOUR_SETTINGS_REVISION'
    };

  kintoneApp.updateGeneralSettings(params).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

getFormFields(params)

Get field of form in kintone app

Parameters

Name Type Required Description
params Object yes Get form fields params.
params.app Integer yes The app ID
params.lang String (optional) The language code. Support:
  • DEFAULT: Default language setting of system
  • JA: English language setting
  • ZH: Chinese language setting
  • EN: English language setting
params.isPreview Boolean (optional) Get the app form fields with a pre-live settings.

Return

Promise

Sample code

Get app form field sample Javascript 

  var app = YOUR_APP_ID;
  var lang = 'LANGUAGE_CODE'; // Ex: JA
  kintoneApp.getFormFields({app, lang}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

  // Get a pre-live (preview) form fields
  var app = YOUR_APP_ID;
  var lang = 'LANGUAGE_CODE'; // Ex: JA
  var isPreview = true;
  kintoneApp.getFormFields({app, lang, isPreview}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const app = YOUR_APP_ID;
  const lang = 'LANGUAGE_CODE'; // Ex: JA
  kintoneApp.getFormFields({app, lang}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

  // Get a pre-live (preview) form fields
  const app = YOUR_APP_ID;
  const lang = 'LANGUAGE_CODE'; // Ex: JA
  const isPreview = true;
  kintoneApp.getFormFields({app, lang, isPreview}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

addFormFields(params)

Adds fields to a form of an App.

Warning

  • After using this method, use the deployAppSettings to deploy the settings to the live App.

Parameters

Name Type Required Description
params Object yes Params to add form fields.
params.app Integer yes The app ID
params.fields JSONObject yes The formFields which will add to form of kintone app. About the format, please look the sample below or reference at the end of this
params.revision Integer (optional) Specify the revision number of the settings that will be deployed.

Return

Promise

Sample code

Add app form field sample Javascript 

  var app = YOUR_APP_ID;
  var fields = {
    'YOUR_FIELD_CODE': {
      'type': 'SINGLE_LINE_TEXT',
      'code': 'YOUR_FIELD_CODE',
      'label': 'Text (single-line)',
      'noLabel': false,
      'required': true,
      'unique': true
    }
    // Another field here
  };
  var revision = 'YOUR_SETTINGS_REVISION';
  kintoneApp.addFormFields({app, fields, revision}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const app = YOUR_APP_ID;
  const fields = {
    'YOUR_FIELD_CODE': {
      'type': 'SINGLE_LINE_TEXT',
      'code': 'YOUR_FIELD_CODE',
      'label': 'Text (single-line)',
      'noLabel': false,
      'required': true,
      'unique': true
    }
    // Another field here
  };
  const revision = 'YOUR_SETTINGS_REVISION';
  kintoneApp.addFormFields({app, fields, revision}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

updateFormFields(params)

Updates the field settings of fields in a form of an App.

Warning

  • After using this method, use the deployAppSettings to deploy the settings to the live App.

Parameters

Name Type Required Description
params Object yes Params to update form fields.
params.app Integer yes The app ID
params.fields JSONObject yes The formFields which will add to form of kintone app. About the format, please look the sample below or reference at the end of this
params.revision Integer (optional) Specify the revision number of the settings that will be deployed.

Return

Promise

Sample code

Update app form field sample Javascript 

  var app = YOUR_APP_ID;
  var fields = {
    'YOUR_FIELD_CODE': {
      'type': 'SINGLE_LINE_TEXT',
      'code': 'YOUR_FIELD_CODE',
      'label': 'Text (single-line)',
      'noLabel': false,
      'required': true,
      'unique': true
    }
    // Another field here
  };
  var revision = 'the_revision_of_the_settings ';
  kintoneApp.updateFormFields({app, fields, revision}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const app = YOUR_APP_ID;
  const fields = {
    'YOUR_FIELD_CODE': {
      'type': 'SINGLE_LINE_TEXT',
      'code': 'YOUR_FIELD_CODE',
      'label': 'Text (single-line)',
      'noLabel': false,
      'required': true,
      'unique': true
    }
    // Another field here
  };
  const revision = 'YOUR_SETTINGS_REVISION';
  kintoneApp.updateFormFields({app, fields, revision}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

deleteFormFields(params)

Updates the field settings of fields in a form of an App.

Warning

  • After using this method, use the deployAppSettings to deploy the settings to the live App.

Parameters

Name Type Required Description
params Object yes Params to delete form fields.
params.app Integer yes The app ID
params.fields Array<String> yes The list of field codes of the fields to delete. Up to 100 field codes can be specified.
params.revision Integer (optional) Specify the revision number of the settings that will be deployed.

Return

Promise

Sample code

Delete app form field sample Javascript 

  var app = YOUR_APP_ID;
  var fields = [
    'YOUR_FIELD_CODE'
    // Another field code here
  ];
  var revision = 'YOUR_SETTINGS_REVISION';
  kintoneApp.deleteFormFields({app, fields, revision}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const app = YOUR_APP_ID;
  const fields = [
    'YOUR_FIELD_CODE'
    // Another field code here
  ];
  const revision = 'YOUR_SETTINGS_REVISION';
  kintoneApp.deleteFormFields({app, fields, revision}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

getFormLayout(params)

Get layout of form in kintone app

Parameters

Name Type Required Description
params Object yes Get form layout params.
params.app Integer yes The kintone app id
params.isPreview Boolean (optional) Get the app form layout with a pre-live settings.

Return

Promise

Sample code

Get form layout sample Javascript 

  var app = YOUR_APP_ID;
  // Get form layout
  kintoneApp.getFormLayout({app}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

  // Get a preview (pre-live) form layout
  var isPreview = true;
  kintoneApp.getFormLayout({app, isPreview}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const app = YOUR_APP_ID;
  // Get form layout
  kintoneApp.getFormLayout({app}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

  // Get a preview (pre-live) form layout
  const isPreview = true;
  kintoneApp.getFormLayout({app, isPreview}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });

updateFormLayout(params)

Updates the field layout info of a form in an App.

Warning

  • After using this method, use the deployAppSettings to deploy the settings to the live App.

Parameters

Name Type Required Description
params Object yes Params to update form layout.
params.app Integer yes The kintone app id
params.layout Array<JSONObject> yes A list of field layouts for each row. About the format, please look the sample below or reference at the end of this page.
params.revision Integer (optional) Specify the revision number of the settings that will be deployed. The request will fail if the revision number is not the latest revision.

Return

Promise

Sample code

Update form layout sample Javascript 

  var app = YOUR_APP_ID;
  var firstRowLayout = {
    'type': 'YOUR_LAYOUT_TYPE',
    'fields': [
      {
        'type': 'YOUR_FIELD_TYPE',
        'code': 'YOUR_FIELD_CODE',
        'size': {
          'width': 'YOUR_FIELD_WIDTH'
        }
      }
    ]
  };
  var layout = [
    firstRowLayout
    // Another row layout here
  ];
  var revision = 'YOUR_SETTINGS_REVISION';

  // Update form layout
  kintoneApp.updateFormLayout({app, layout, revision}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
    // This SDK return err with KintoneAPIException
    console.log(err);
  });
Nodejs 

  const app = YOUR_APP_ID;
  const fisrtRowLayout = {
    'type': 'YOUR_LAYOUT_TYPE',
    'fields': [
      {
        'type': 'YOUR_FIELD_TYPE',
        'code': 'YOUR_FIELD_CODE',
        'size': {
          'width': 'YOUR_FIELD_WIDTH'
        }
      }
    ]
  };
  const layout = [
    fisrtRowLayout
  // Another row layout here
  ];
  const revision = 'YOUR_SETTINGS_REVISION';

  // Update form layout
  kintoneApp.updateFormLayout({app, layout, revision}).then((rsp) => {
    console.log(rsp);
  }).catch((err) => {
  // This SDK return err with KintoneAPIException
    console.log(err);
  });

Reference

Developer network's reference:
Get App
Get Apps
Get Form fields
Add Form Fields
Update Form Fields
Delete Form Fields
Get Form Layout
Deploy App Settings
Get App Deploy Status
Get Views
Update Views
Get General Settings
Update General Settings
Get Form Layout
Update Form Layout