Updates the Status of a record of an App, that was set with the Process Management feature.
Method | PUT |
URL | https://{subdomain}.kintone.com/k/v1/record/status.json |
URL(guest space) | https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/record/status.json |
Authentication | API Token Authentication , Password Authentication |
Content-Type | application/json |
Permissions
For Password Authentication, the user must have permission to view the record. Also, one of the following conditions must be met:
- The user is the Assignee of the record
- There are no Assignees set for the record
For API Token Authentication, the API Token must have permission to view the record. Also, one of the following conditions must be met:
- The user "Administrator" is the Assignee of the record
- There are no Assignees set for the record
Request Parameters
PARAMETER | VALUE | REQUIRED | DESCRIPTION |
---|---|---|---|
action | String | Yes |
The Action name of the action to run.
|
app | Integer | Yes | The App ID. |
assignee | String | Conditionally required | The next Assignee. Specify the Assignee's log in name. Required, if the "Assignee List" of the current status is set to "User chooses one assignee from the list to take action", and a selectable assignee exists. |
id | Integer | Yes | The record ID. |
revision | Integer | Optional | The revision number of the record before updating the status. If the specified revision is not the latest revision, the request will result in an error. The revision will not be checked if this parameter is ignored, or -1 is specified. |
Sample Request
JavaScript (using Kintone REST API Request)
curl Sample
Response Parameters
PARAMETER | VALUE | DESCRIPTION |
---|---|---|
revision | String | The revision number of the record after updating the status. The revision number will increase by 2, as two operations are preformed - running the action, and updating the status. |
Sample Response
Limitations
- This API can only be used with Apps that have the Process Management feature enabled.