案件を更新

ユーザー

ユーザーに関する操作

Operations

ユーザーグループ

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

Operations

ワークスペース

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

Operations

部署

部署に関する操作

Operations

契約書（ファイル）

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

Operations

案件

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

Operations

案件を取得

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

案件を削除

Request

指定した案件を削除します。

Security

OAuth2ClientCredentials

Path

matter_idstring(uuid)required

LegalOn が生成した案件 ID。

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

Responses

正常に案件を削除

Response

No content

ファイル

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

Operations

ワークスペース

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

Operations

LegalOn API (1.3.1)

ユーザー

ユーザーグループ

ワークスペース

部署

契約書（ファイル）

案件

案件を取得

Request

Responses

案件を更新

RequestExpand all

概要

処理上の注意

Responses

案件を削除

Request

Responses

ファイル

ワークスペース

Request