Matters Overview

Matters are the workspace primitive for legal work on Case.dev. A matter owns the operating context: metadata, its primary vault, work items, parties, audit logs, and sharing.

Open API All Services

CreatePOST /matters/v1

TrackPOST /matters/v1//work-items

DecidePOST /matters/v1//work-items//decision

What a matter owns

Primary vault linkage
Work items and decision history
Reusable parties and matter-specific roles
Optional playbook (matter type) for agent instructions
Audit logs, exports, events, and shares

Core resources

Resource	Endpoint family	Purpose
Matter	`/matters/v1`	Create, update, and inspect legal workspaces
Matter types	`/matters/v1/types`	Optional playbooks with agent instructions
Agent types	`/matters/v1/agent-types`	Reusable agent role definitions
Parties	`/matters/v1/parties`	Reusable people and organizations
Matter parties	`/matters/v1/{id}/parties`	Attach parties to a matter with roles
Work items	`/matters/v1/{id}/work-items`	Create and manage legal tasks
Decisions	`/matters/v1/{id}/work-items/{workItemId}/decision`	Approve or block work
Logs	`/matters/v1/{id}/log`	Operational history and exports
Shares	`/matters/v1/{id}/shares`	Cross-org matter access

How it works

The matters API is a task board and system of record for legal work.

Create a work item to describe and track a unit of work.
Perform intensive agent work in Linc and attach the results to your application workflow.
Update the work item as its state changes.
Record a decision to approve or block the work.

Work items can keep application-specific dependencies and result references in metadata.

Quickstart

Shell

# Create a matter
curl https://api.case.dev/matters/v1 \
  -H "Authorization: Bearer $CASEDEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Doe v. Example Corp.",
    "practice_area": "litigation"
  }'

Shell

# Create a work item
curl https://api.case.dev/matters/v1/$MATTER_ID/work-items \
  -H "Authorization: Bearer $CASEDEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Review demand letter",
    "type": "review",
    "instructions": "Check all citations and verify damages calculations against the medical records."
  }'

Shell

# Block a work item with a reason
curl https://api.case.dev/matters/v1/$MATTER_ID/work-items/$WORK_ITEM_ID/decision \
  -H "Authorization: Bearer $CASEDEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "decision": "block",
    "reason": "Citation on page 3 was overturned in 2024."
  }'

The full schema and every tagged operation live in the API Reference.

Get Started

Platform

Resources

What a matter owns

Core resources

How it works

Quickstart

​What a matter owns

​Core resources

​How it works

​Quickstart

What a matter owns

Core resources

How it works

Quickstart