案件メッセージを更新

ユーザー

ユーザーに関する操作

Operations

ユーザーグループ

ユーザーグループに関する操作

Operations

ワークスペース

ユーザーの閲覧権限によらず、テナント内のすべてのワークスペース/フォルダに関する操作

Operations

部署

部署に関する操作

Operations

契約書（ファイル）

契約書の作成・取得・更新・削除などの操作を提供します。ワークスペースを対象とする操作では、共通の「ワークスペース」（GET /workspaces）で取得した workspace_id を指定してください。

Operations

案件

案件の作成、取得、更新、削除などの操作を提供します。案件の操作には、マターマネジメント Pro ライセンスを持つユーザーが所有する API クレデンシャルが必要です。

Operations

案件メッセージを作成

Request

概要

指定した案件に公開メッセージまたは非公開メッセージを作成します。任意で最大10件の新規ファイルを添付できます。

指定項目

新規ファイルはmultipart/form-dataのファイルパートにバイナリとして含めて送信してください。アップロードURL、ファイルパス、オブジェクトパスを取得・指定する必要はありません。

制約

1ファイルあたり100MiB以下、合計200MiB以下とします。
いずれかのファイルの検証またはアップロードに失敗した場合、メッセージを作成せずにリクエスト全体が失敗します。

処理上の注意

非公開メッセージにはセンシティブな情報が含まれる可能性があります。外部へ複製する場合は適切なアクセス制御を維持してください。
冪等性キーには対応していません。処理完了後に応答を受信できなかった場合、再送前にメッセージが作成済みでないか確認してください。再送するとメッセージと添付ファイルが重複して作成される可能性があります。

Security

OAuth2ClientCredentials

Path

matter_idstring(uuid)required

LegalOn が生成した案件 ID。

Bodymultipart/form-datarequired

案件メッセージ作成リクエスト。

contentobject(MessageContent)required

構造化されたメッセージ本文。各 blocks 要素は指定順に段落として表示します。

テキストとメンション先ユーザーIDを合計した文字数は1文字以上4000文字以下です。

content.blocksArray of objects(MessageContentBlock)non-emptyrequired

指定順に表示する段落。inlines が空のブロックは空行を表します。

content.blocks[].inlinesArray of objects(MessageContentInline)required

段落内のインライン要素。指定した順序で表示します。空行は空の配列で表します。

content.blocks[].inlines[].typestringrequired

インライン要素の種類。

Enum"text""mention"

content.blocks[].inlines[].textstring[ 1 .. 4000 ] characters

表示するテキスト。type が text の場合は必須、mention の場合は省略します。

content.blocks[].inlines[].user_idstring(uuid)

メンションするユーザーについてLegalOnが生成したユーザーID。type が mention の場合は必須、text の場合は省略します。

content.blocks[].inlines[].marksArray of strings(MessageInlineMarks)<= 3 itemsunique

インライン要素に適用する文字装飾。装飾しない場合は省略します。指定順に意味はありません。

Items Enum"bold""strikethrough""underline"

visibilitystring(MessageVisibility)required

メッセージに設定する公開範囲。指定できる値は public（公開メッセージ）または private（非公開メッセージ）です。

Enum"public""private"

filesArray of strings(binary)<= 10 items

新規アップロードするバイナリファイル。フォームフィールドは最大10回指定できます。

ファイル名と Content-Type は各 multipart/form-data のファイルパートから取得します。ファイル名やMIMEタイプを別のメタデータフィールドで指定したり、保存先のパスを指定したりすることはできません。

ファイル名は拡張子を含めて200文字以下とし、改行を含めず、先頭または末尾をピリオドにしないでください。
対応拡張子は .pdf、.doc、.docx、.xls、.xlsx、.csv、.ppt、.pptx、.eml、.msg、.png、.gif、.jpg、.jpeg です。
Content-Type は POST /files と同じメディアタイプ規則に従って拡張子と一致させてください。

curl -i -X POST \
  'https://{api_base_url_without_scheme}/rest/v1/matters/{matter_id}/messages' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: multipart/form-data' \
  -F 'content[blocks][0][inlines][0][type]=text' \
  -F 'content[blocks][0][inlines][0][text]=Please review ' \
  -F 'content[blocks][0][inlines][1][type]=mention' \
  -F 'content[blocks][0][inlines][1][user_id]=00000000-0000-0000-0000-000000000001' \
  -F 'content[blocks][0][inlines][1][marks]=bold' \
  -F 'content[blocks][0][inlines][2][type]=text' \
  -F 'content[blocks][0][inlines][2][text]=the latest revision.' \
  -F 'content[blocks][0][inlines][2][marks]=bold' \
  -F 'content[blocks][0][inlines][2][marks]=underline' \
  -F 'content[blocks][2][inlines][0][type]=text' \
  -F 'content[blocks][2][inlines][0][text]=Comments are welcome.' \
  -F visibility=public \
  -F 'files=<binary file content>'

Responses

正常にメッセージを作成

Bodyapplication/json

message_idstring(uuid)required

LegalOn が生成したメッセージ ID。

Response

application/json

{
  "message_id": "00000000-0000-0000-0000-000000000030"
}