Kintone REST API

Documents for REST APIs for App, record, file and Space management.

Apps

Category	API	Method	URL
Apps	Get App	GET	/k/v1/app.json
	Get Apps	GET	/k/v1/apps.json
	Add Preview App	POST	/k/v1/preview/app.json
Deploy	Deploy App Settings	POST	/k/v1/preview/app/deploy.json
	Get App Deploy Status	GET	/k/v1/preview/app/deploy.json
Form Fields	Get Form Fields	GET	/k/v1/app/form/fields.json /k/v1/preview/app/form/fields.json
	Add Form Fields	POST	/k/v1/preview/app/form/fields.json
	Update Form Fields	PUT	/k/v1/preview/app/form/fields.json
	Delete Form Fields	DELETE	/k/v1/preview/app/form/fields.json
Form Layout	Get Form Layout	GET	/k/v1/app/form/layout.json /k/v1/preview/app/form/layout.json
	Update Form Layout	PUT	/k/v1/preview/app/form/layout.json
Views	Get Views	GET	/k/v1/app/views.json /k/v1/preview/app/views.json
	Update Views	PUT	/k/v1/preview/app/views.json
General Settings	Get General Settings	GET	/k/v1/app/settings.json /k/v1/preview/app/settings.json
	Update General Settings	PUT	/k/v1/preview/app/settings.json
Process Management	Get Process Management Settings	GET	/k/v1/app/status.json /k/v1/preview/app/status.json
	Update Process Management Settings	PUT	/k/v1/preview/app/status.json
Customization	Get Customization	GET	/k/v1/app/customize.json /k/v1/preview/app/customize.json
	Update Customization	PUT	/k/v1/preview/app/customize.json
App Permissions	Get App Permissions	GET	/k/v1/app/acl.json /k/v1/preview/app/acl.json
	Update App Permissions	PUT	/k/v1/app/acl.json /k/v1/preview/app/acl.json
Record Permissions	Get Record Permissions	GET	/k/v1/record/acl.json /k/v1/preview/record/acl.json
	Update Record Permissions	PUT	/k/v1/record/acl.json /k/v1/preview/record/acl.json
Field Permissions	Get Field Permissions	GET	/k/v1/field/acl.json /k/v1/preview/field/acl.json
	Update Field Permissions	PUT	/k/v1/field/acl.json /k/v1/preview/field/acl.json
Record Permissions	Evaluate Record Permissions	GET	/k/v1/records/acl/evaluate.json
General Notifications	Get General Notification Settings	GET	/k/v1/app/notifications/general.json /k/v1/preview/app/notifications/general.json
	Update General Notification Settings	PUT	/k/v1/preview/app/notifications/general.json
Per Record Notifications	Get Per Record Notification Settings	GET	/k/v1/app/notifications/perRecord.json k/v1/preview/app/notifications/perRecord.json
	Update Per Record Notification Settings	PUT	k/v1/preview/app/notifications/perRecord.json
Reminder Notifications	Get Reminder Notification Settings	GET	/k/v1/app/notifications/reminder.json /k/v1/preview/app/notifications/reminder.json
	Update Reminder Notification Settings	PUT	/k/v1/preview/app/notifications/reminder.json
Graph Settings	Get Graph Settings	GET	/k/v1/app/reports.json /k/v1/preview/app/reports.json
	Update Graph Settings	PUT	/k/v1/preview/app/reports.json
Action Settings	Get Action Settings	GET	/k/v1/app/actions.json /k/v1/preview/app/actions.json
	Update Action Settings	PUT	/k/v1/preview/app/actions.json
Get Form	Get Form	GET	/k/v1/form.json /k/v1/preview/form.json
Move App	Move App to Space	POST	/k/v1/app/move.json
Plug-ins	Get App Plug-ins	GET	/k/v1/app/plugins.json
	Add Plug-ins	POST	/k/v1/app/plugins.json
Admin Notes	Get App Admin Notes	GET	/k/v1/app/adminNotes.json
	Update App Admin Notes	PUT	/k/v1/app/adminNotes.json

* Certain APIs concerning Apps can be executed only on form settings that have not been applied to the live App (ie. changes were made to the form settings but the App has not been updated), only on the live App, or either.

* The URL path in the case of settings that have not yet been updated to the live App is '/k/v1/preview/xxxx.json'. Refer to each individual document for details.

Records

Category	API	Method	URL
Record	Get Record	GET	/k/v1/record.json
	Get Records	GET	/k/v1/records.json
	Add Record	POST	/k/v1/record.json
	Add Records	POST	/k/v1/records.json
	Update Record	PUT	/k/v1/record.json
	Update Records	PUT	/k/v1/records.json
	Delete Records	DELETE	/k/v1/records.json
Cursor	Get Cursor	GET	/k/v1/records/cursor.json
	Add Cursor	POST	/k/v1/records/cursor.json
	Delete Cursor	DELETE	/k/v1/records/cursor.json
Comments	Get Comments	GET	/k/v1/record/comments.json
	Add Comment	POST	/k/v1/record/comment.json
	Delete Comment	DELETE	/k/v1/record/comment.json
Bulk Request	Bulk Request	POST	/k/v1/bulkRequest.json
Process Management	Update Status	PUT	/k/v1/record/status.json
	Update Multiple Statuses	PUT	/k/v1/records/status.json
	Update Assignees	PUT	/k/v1/record/assignees.json

Files

Category	API	Method	URL
File	Download File	GET	/k/v1/file.json
	Upload File	POST	/k/v1/file.json

Spaces

Category	API	Method	URL
Space	Get Space	GET	/k/v1/space.json
	Add Space	POST	/k/v1/template/space.json
	Update Space Body	PUT	/k/v1/space/body.json
	Delete Space	DELETE	/k/v1/space.json
Space Members	Get Space Members	GET	/k/v1/space/members.json
	Update Space Members	PUT	/k/v1/space/members.json
Thread	Add Thread Comment	POST	/k/v1/space/thread/comment.json
	Add Thread	POST	/k/v1/space/thread.json
	Update Thread	PUT	/k/v1/space/thread.json
Guests	Add Guests	POST	/k/v1/guests.json
	Update Guest Members	PUT	/k/guest/<SpaceID>/v1/space/guests.json
	Delete Guests	DELETE	/k/v1/guests.json

Plug-ins

Category	API	Method	URL
Plug-ins	Get Installed Plug-ins	GET	/k/v1/plugins.json
	Install Plug-in	POST	/k/v1/plugin.json
	Update Plug-in	PUT	/k/v1/plugin.json
	Uninstall Plug-in	DELETE	/k/v1/plugin.json
	Get Plug-in Apps	GET	/k/v1/plugin/apps.json
	Get Required Plug-ins	GET	/k/v1/plugins/required.json

API Info

Category	API	Method	URL
Kintone REST API	Get API List	GET	/k/v1/apis.json
	Get API Schema	GET	/k/v1/apis/*.json