kintone developer network

Update Assignees

Follow

Update AssigneesPUT /assignees.json

Update assignees of a record.
URI
https://{subdomain}.kintone.com/k/v1/record/assignees.json
URI for Guest Space Apps
https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/record/assignees.json

Permissions

The user or API Token must both have permission to manage the app and view records.

Request Parameters

PARAMETER VALUE REQUIRED DESCRIPTION
app Integer or String Yes The App ID.
record Integer or String Yes The Record ID.
assigness Array Yes The user code(s) of the assignee(s). If empty, no users will be assigned. The maximum number of assignees is 100.
revision Integer or String Optional The revision number of the record before updating the assignees. 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

Header

PUT /k/v1/record/assignees.json HTTP/1.1
Host: example.kintone.com:443
X-Cybozu-Authorization: a2ludG9uZTpkZXZlbG9wZXI=
Authorization: Basic a2ludG9uZTpkZXZlbG9wZXI=
Content-Type: application/json

Body

{
    "app": 1,
    "id": 1,
    "assignees": ["user2"],
    "revision": 1
}

Response Parameters

PARAMETER VALUE DESCRIPTION
revision String The revision number of the record after updating the assignees.

Sample Response

{
    "revision": "2"
}

Limitations

  • This API can only be used with apps that have the Process Management feature enabled.
  • Updating assignees will be recorded in the record's History.
  • The request will result in an error if a user without permission is assigned as an assignee.
  • The error will return if more than 2 assignees are assigned on a status that only allows one assignee.

Related Article

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request
Comments