API Updates for March 2021

API Updates

Update Summary

The March update consists of new APIs related to the App’s App Actions .

Similar to the APIs added in the January and February updates, these APIs allow for getting and updating settings that previously required using Kintone’s graphical interface. Now copying over App Actions from the testing to the production environment is easier with the new APIs.

In addition to the new Kintone REST API, a new User API to update the Department Membership of a User will be added. This will be helpful for Kintone Administrators to maintain user information on Kintone.

Kintone REST API

New features

  • New APIs will be added to get and update the App Actions of Apps.
    • Relevant APIs
      • /k/v1/app/actions.json [GET]
      • /k/v1/preview/app/actions.json [GET, PUT]

Spec Changes

  • The format of a Date and time field’s defaultValue will be changed to “yyyy-MM-ddTHH:mm”.
    • Relevant API
    • Details
      • Before the change: defaultValue is formatted as “yyyy-MM-ddTHH:mm:ss.SSSZ”
      • After the change: defaultValue is formatted as “yyyy-MM-ddTHH:mm”

Bug Fixes

  • A bug exists where APIs would return an error when null is specified within Table fields. This bug will be fixed.
    • Related APIs

    • Conditions
      When one of the following conditions apply:

      • Specify null for the Table field’s value and add or update the record using a related API.

        1
        2
        3
        4
        5
        
        {
          "Table": {
            "value": null
          }
        }
        
      • Specify null for the row’s value within the Table field and add or update the record using a related API.

        1
        2
        3
        4
        5
        
        {
          "Table": {
            "value": [{ "value": null }]
          }
        }
        
    • Details

      • Before the fix: The Illegal request error message is returned, and the operation fails.
      • After the fix: Depending on the request parameters, the contents of the saved Table field will be as follows:
        • When null is specified for the Table field’s value: A table with empty rows is saved.
        • When null is specified for the row’s value within the Table field: A table with no row is saved.
    • Note: When null is specified for the table field’s row, a Missing or invalid input error message is returned and the operation fails.

      1
      2
      3
      4
      5
      
      {
        "Table": {
          "value": [null]
        }
      }
      

User API

New Features

Spec changes

  • Traditional Chinese can be specified for the Display name in another language setting.
  • The status code and the error message returned when using the Add Users API without specifying the User Code will be changed.
    • Related APIs
    • Conditions
      • A user is added using the Add Users API and the code parameter is not specified.
    • Details
      • Before the fix: Status code 520 and Illegal request error message is returned, and the operation fails.
      • After the fix: Status code 400 and Missing or invalid input error message is returned, and the operation fails.