案件を取得

ユーザー

ユーザーに関する操作

Operations

ユーザーグループ

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

Operations

ワークスペース

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

Operations

部署

部署に関する操作

Operations

契約書（ファイル）

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

Operations

案件

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

Operations

案件を作成

Request

概要

案件を作成します。1回のリクエストで、依頼者、依頼部署、案件ステータス、主・副担当者、カスタム項目、最大10件の新規ファイルを指定できます。

指定項目

依頼者は必須で、メールアドレスと氏名で指定します。LegalOnは有効なユーザーを優先し、該当しない場合は既存ゲストの再利用または新規作成を行います。ユーザーまたはゲストのIDは直接指定できません。

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

制約

このAPIは単件作成用です。データ移行のために繰り返し呼び出せますが、移行元の作成日時は保持できません。
1ファイルあたり100MiB以下、合計200MiB以下とします。

処理上の注意

いずれかのファイルの検証またはアップロードに失敗した場合、案件を作成せずにリクエスト全体が失敗します。
冪等性キーには対応していません。処理完了後に応答を受信できなかった場合、再送前に案件が作成済みでないか確認してください。再送すると案件と添付ファイルが重複して作成される可能性があります。

Security

OAuth2ClientCredentials

Bodymultipart/form-datarequired

案件作成リクエスト。

titlestring[ 1 .. 200 ] charactersrequired

案件名。

matter_typestringrequired

案件タイプ。

Enum"other""legal_request""contract_review""contract_drafting"

workspace_idstring(uuid)required

案件を作成するワークスペース。

overviewstring[ 1 .. 4000 ] characters

案件概要。

due_datestring(date-time)

納期。

requesterobject(RequesterInput)required

メールアドレスと氏名で指定する依頼者。ユーザーまたはゲストのIDは直接指定できません。

requester.emailstring(email)<= 254 charactersrequired

依頼者のメールアドレス。LegalOnは有効なユーザーを優先し、該当しない場合は既存ゲストの再利用または新規作成を行います。

requester.namestring[ 1 .. 300 ] charactersrequired

依頼者の氏名。既存ゲストを再利用する場合は、この値で氏名を更新します。

requesting_department_idstring(uuid)

設定する依頼部署。

status_idstring(uuid)

設定する案件ステータス。省略した場合は既定の案件ステータスを使用します。

main_assignee_idstring(uuid)

主担当者のユーザー ID。

sub_assignee_idsArray of strings(uuid)<= 30 itemsunique

副担当者のユーザー ID。同じユーザー ID は重複して指定できません。

custom_attributesArray of objects(MatterCustomAttributePatch)[ 1 .. 50 ] items

設定するカスタム項目。

指定しない定義は設定されません。
同じ定義 ID は重複して指定できません。

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' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: multipart/form-data' \
  -F 'title=Review NDA' \
  -F matter_type=contract_review \
  -F workspace_id=00000000-0000-0000-0000-000000000003 \
  -F 'overview=Please review this NDA.' \
  -F 'requester[email]=requester@example.com' \
  -F 'requester[name]=Request User' \
  -F status_id=00000000-0000-0000-0000-000000000002 \
  -F main_assignee_id=00000000-0000-0000-0000-000000000004 \
  -F sub_assignee_ids=00000000-0000-0000-0000-000000000005 \
  -F 'custom_attributes[0][custom_attribute_definition_id]=00000000-0000-0000-0000-000000000010' \
  -F 'custom_attributes[0][text_value]=High priority' \
  -F 'files=<binary file content>'

Responses

正常に案件を作成

Bodyapplication/json

matter_idstring(uuid)required

LegalOn が生成した案件 ID。

Response

application/json

{
  "matter_id": "00000000-0000-0000-0000-000000000001"
}

案件を取得

Request

指定した案件を取得します。紐付け済みファイルとタイムラインは含みません。

Security

OAuth2ClientCredentials

Path

matter_idstring(uuid)required

LegalOn が生成した案件 ID。

curl -i -X GET \
  'https://{api_base_url_without_scheme}/rest/v1/matters/{matter_id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

正常に案件を取得

Bodyapplication/json

matter_idstring(uuid)required

LegalOn が生成した案件 ID。

matter_numberstringnon-emptyrequired

案件番号。

titlestringnon-emptyrequired

案件名。

overviewstringnon-empty

案件概要。未設定の場合は省略します。

matter_typestringrequired

案件タイプ。

Enum"other""legal_request""contract_review""contract_drafting"

due_datestring(date-time)

納期。未設定の場合は省略します。

statusobject(MatterStatus)required

案件ステータス。

status.status_idstring(uuid)required

LegalOn が生成した案件ステータスID。

status.display_namestringnon-emptyrequired

案件ステータス名。

assigneeobject(MainAssigneeReference)

案件の主担当者。未設定の場合は省略します。

secondary_assigneeArray of objects(UserReference)required

案件の副担当者。

secondary_assignee[].user_idstring(uuid)required

LegalOn が生成したユーザー ID。

secondary_assignee[].display_namestringnon-emptyrequired

ユーザー表示名。

requesterobject(RequesterReference)

案件の依頼者として解決されたユーザーまたはゲスト。

requesting_departmentobject(DepartmentReference)

部署参照。

custom_attributesArray of objects(MatterCustomAttribute)required

案件に設定されたカスタム項目。

custom_attributes[].custom_attribute_definitionobject(MatterCustomAttributeDefinition)required

案件カスタム項目の定義。

custom_attributes[].custom_attribute_definition.custom_attribute_definition_idstring(uuid)required

LegalOn が生成したカスタム項目定義 ID。

custom_attributes[].custom_attribute_definition.display_namestringnon-emptyrequired

カスタム項目の表示名。

custom_attributes[].custom_attribute_definition.kindstringrequired

カスタム項目の値の種類。

Enum"single_selection""multiple_selection""single_line_text""number""date"

custom_attributes[].custom_attribute_definition.display_orderinteger>= 0required

カスタム項目の表示順。

custom_attributes[].custom_attribute_definition.optionsArray of objects(MatterCustomAttributeOption)required

選択可能な選択肢。選択型以外では空です。

custom_attributes[].custom_attribute_definition.options[].custom_attribute_option_idstring(uuid)required

LegalOn が生成したカスタム項目選択肢 ID。

custom_attributes[].custom_attribute_definition.options[].display_namestringnon-emptyrequired

選択肢の表示名。

custom_attributes[].custom_attribute_definition.options[].display_orderinteger>= 0required

選択肢の表示順。

custom_attributes[].option_idsArray of strings(uuid)

選択型カスタム項目の選択肢 ID。

custom_attributes[].text_valuestringnon-empty

一行テキスト型カスタム項目の値。

custom_attributes[].number_valueinteger(int32)>= 0

数値型カスタム項目の値。

custom_attributes[].date_valuestring(date-time)

日付型カスタム項目の値。

workspaceobject(WorkspaceReference)required

ワークスペース参照。API クレデンシャルの所有者がワークスペースを閲覧できない場合は、両方のフィールドを省略し、空のオブジェクトを返します。

workspace.workspace_idstring(uuid)

LegalOn が生成したワークスペース ID。

workspace.display_namestringnon-empty

ワークスペース表示名。

created_atstring(date-time)required

案件の作成日時。

last_message_atstring(date-time)

最終メッセージの日時。メッセージが存在しない場合は省略します。

Response

application/json

{
  "matter_id": "00000000-0000-0000-0000-000000000001",
  "matter_number": "MAT-0001",
  "title": "Review NDA",
  "overview": "Please review this NDA.",
  "matter_type": "contract_review",
  "status": {
    "status_id": "00000000-0000-0000-0000-000000000002",
    "display_name": "In progress"
  },
  "secondary_assignee": [],
  "custom_attributes": [],
  "workspace": {
    "workspace_id": "00000000-0000-0000-0000-000000000003",
    "display_name": "Legal"
  },
  "created_at": "2026-08-18T00:00:00Z",
  "last_message_at": "2026-08-18T00:00:00Z"
}

案件を更新

Request

概要

案件の基本項目、依頼者、依頼部署、案件ステータス、主・副担当者、カスタム項目を1回のリクエストで部分更新します。

処理上の注意

依頼者を指定した場合は有効なユーザーを優先し、該当しない場合は既存ゲストの再利用または新規作成を行います。
依頼者を省略した場合は既存の依頼者を保持し、その他の省略した項目も変更しません。

Security

OAuth2ClientCredentials

Path

matter_idstring(uuid)required

LegalOn が生成した案件 ID。

Bodyapplication/jsonrequired

案件部分更新リクエスト。

non-empty

titlestring[ 1 .. 200 ] characters

案件名。

overviewstring[ 1 .. 4000 ] characters

案件概要。

matter_typestring

案件タイプ。

Enum"other""legal_request""contract_review""contract_drafting"

due_datestring or null(date-time)

納期。null を指定すると解除し、省略すると変更しません。

status_idstring(uuid)

設定する案件ステータス。

requesterobject(RequesterInput)

メールアドレスと氏名で指定する依頼者。ユーザーまたはゲストのIDは直接指定できません。

requesting_department_idstring or null(uuid)

設定する依頼部署。null を指定すると解除します。

main_assignee_idstring or null(uuid)

主担当者のユーザー ID。null を指定すると主担当者を解除します。

sub_assignee_idsArray of strings(uuid)<= 30 itemsunique

副担当者のユーザー ID の全量。

空配列を指定するとすべて解除します。
同じユーザー ID は重複して指定できません。

custom_attributesArray of objects(MatterCustomAttributePatch)[ 1 .. 50 ] items

更新するカスタム項目。

指定しない定義は変更しません。
同じ定義 ID は重複して指定できません。

curl -i -X PATCH \
  'https://{api_base_url_without_scheme}/rest/v1/matters/{matter_id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Review mutual NDA",
    "due_date": null,
    "status_id": "00000000-0000-0000-0000-000000000002",
    "requester": {
      "email": "requester@example.com",
      "name": "Request User"
    },
    "main_assignee_id": "00000000-0000-0000-0000-000000000004",
    "sub_assignee_ids": [
      "00000000-0000-0000-0000-000000000005"
    ],
    "custom_attributes": [
      {
        "custom_attribute_definition_id": "00000000-0000-0000-0000-000000000010",
        "text_value": "High priority"
      }
    ]
  }'

Responses

正常に案件を更新

Response

No content

ファイル

LegalOn のリソースで利用するファイルを作成・管理します。

Operations

ワークスペース

共通のワークスペース/フォルダは、契約書などのリソースを格納・整理する単位です。

Operations

LegalOn API (1.3.1)

ユーザー

ユーザーグループ

ワークスペース

部署

契約書（ファイル）

案件

案件を作成

RequestExpand all

概要

指定項目

制約

処理上の注意

Responses

案件を取得

Request

Responses

案件を更新

RequestExpand all

概要

処理上の注意

Responses

ファイル

ワークスペース

Request

Request