レコードの作業者を更新する
レコードの作業者を更新します。
- プロセス管理機能を有効にしたアプリで使用できます。
- 作業者の変更後は、レコードの変更履歴に記録されます。
- 権限のないユーザーを作業者に指定した場合にはエラーになります。
- 1名の作業者のみを許容するステータスに、2名以上の作業者を指定した場合にはエラーになります。
URI
https://(サブドメイン名).cybozu.com/k/v1/record/assignees.json
ゲストスペース内のアプリの場合
https://(サブドメイン名).cybozu.com/k/guest/(スペースのID)/v1/record/assignees.json
HTTPメソッド
PUT
必要なアクセス権
- アプリ管理権限
- アプリのレコード閲覧権限
- 作業者を更新するレコードの閲覧権限
リクエストパラメータ
| パラメータ名 | 指定する値 | 必須 | 説明 |
|---|---|---|---|
| app | 数値又は文字列 | 必須 | アプリのIDを指定します。 |
| id | 数値又は文字列 | 必須 | レコードIDを指定します。 |
| assignees | 配列 | 必須 | 作業者にするユーザーコードを指定します。 空の配列を指定すると、空で更新されます。 上限値は100です。 |
| revision | 数値又は文字列 | 変更する前の、レコードのリビジョン番号を指定します。指定したリビジョンが最新ではない場合、リクエストはエラーになります。 指定を省略、または「-1」を指定すると、リビジョンはチェックされません。 |
リクエストの例
ヘッダ
PUT /k/v1/record/assignees.json HTTP/1.1 Host: example.cybozu.com:443 X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU= Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU= Content-Type: application/json
ボディ
レスポンス
パラメータ
| パラメータ名 | 値の種類 | 説明 |
|---|---|---|
| revision | 文字列 | 変更したあとのレコードのリビジョン番号です。 |
レスポンスの例
JavaScriptサンプル
kintone REST APIリクエストを送信する API を使ったリクエスト
XMLHttpRequest を使ったリクエスト
関連
複数レコードに対して適用は可能でしょうか。
ステータスみたいに1つと複数の~という記載が無いので、伺った次第です。
Keisuke さま
こちらのAPIは複数レコードに対しての適用はできません。
なお、レコードステータスの更新APIを用いて、複数レコードの作業者の更新をすることは、ある条件下であれば可能です。
詳細は、複数のレコードのステータスを一括更新する をご確認ください。