レコードの作業者の更新

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

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

• プロセス管理機能を有効にしたアプリで使用できます。
• 作業者の変更後は、レコードの変更履歴に記録されます。
• 権限のないユーザーを作業者に指定した場合にはエラーになります。
• 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

関連

• レコードのステータスの更新