Deploy App Settings
Updates the settings of a pre-live App to the live App.
Using this API is the same as clicking on “Update App” in the Kintone App’s settings. Changes made to pre-live settings will not be deployed to the live app until this API is used.
This API can also be used to revert the pre-live settings back to the current live app settings. This would be the same as clicking on “Discard Changes” in the Kintone App’s settings.
If multiple apps are specified in this API, and one of the updates to an App fails, all of the specified Apps will rollback to the state before this API was run.
Method | POST |
---|---|
URL | https://{subdomain}.kintone.com/k/v1/preview/app/deploy.json |
URL(guest space) | https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/preview/app/deploy.json |
Authentication | API Token Authentication, Password Authentication |
Content-Type | application/json |
Contents
Permissions
- App Management Permissions are needed.
Request Parameters
Parameter | Value | Required | Description |
---|---|---|---|
apps | Array | Yes | The list of Apps to deploy the pre-live settings to the live Apps. The Maximum limit is 300. If Apps are being deployed to Guest Spaces, Apps can only be deployed to the same Guest Space. |
apps[].app | Integer or String | Yes | The App ID. |
apps[].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. |
|
revert | Boolean or String | 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. |
Sample Request
JavaScript (using Kintone REST API Request)
|
|
XMLHttpRequest
|
|
Response Parameters
This API has no responses.
Sample Response
This API has no responses.
Limitations
If APIs to change the App’s settings are run while deploying (or cancelling), an error will be returned.