カテゴリー内の他の記事

レコードの作業者の更新

フォローする

レコードの作業者を更新する

レコードの作業者を更新します。

  • プロセス管理機能を有効にしたアプリで使用できます。
  • 作業者の変更後は、レコードの変更履歴に記録されます。
  • 権限のないユーザーを作業者に指定した場合にはエラーになります。
  • 1名の作業者のみを許容するステータスに、2名以上の作業者を指定した場合にはエラーになります。

URI

https://(サブドメイン名).cybozu.com/k/v1/record/assignees.json

ゲストスペース内のアプリの場合

https://(サブドメイン名).cybozu.com/k/guest/(スペースのID)/v1/record/assignees.json

HTTPメソッド

PUT

アクセス権

次の2つの条件にあてはまる場合にAPIを実行できます。

  • アプリの管理権限のあるユーザーまたはAPIトークン
  • レコードの閲覧権限のあるユーザーまたはAPIトークン

リクエスト

パラメータ

パラメータ名 指定する値 必須 説明
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

XMLHttpRequest

関連

記事に関するフィードバック

直接的に記事と関連がないご質問はcybozu developer コミュニティをご活用ください。

Avatar
Keisuke

複数レコードに対して適用は可能でしょうか。

ステータスみたいに1つと複数の~という記載が無いので、伺った次第です。

Avatar
cybozu Development team

Keisuke さま

こちらのAPIは複数レコードに対しての適用はできません。

なお、レコードステータスの更新APIを用いて、複数レコードの作業者の更新をすることは、ある条件下であれば可能です。

詳細は、複数のレコードのステータスを一括更新する をご確認ください。

ログインしてコメントを残してください。