Redlines

A redline is a proposed markup against a counterparty draft. Eridian prepares it. Counsel edits and sends it. The API does not email the other side and does not apply changes to a signed PDF without a human confirm.

Create

POST /v1/legal/redlines
Authorization: Bearer eridian_sk_...
Idempotency-Key: redline-nda-4821-v1

{
  "project_id": "prj_legal_001",
  "matter_id": "mtr_4821",
  "document_id": "doc_nda_4821",
  "playbook_id": "pos_nda_standard_v4",
  "model": "gpt",
  "routing_policy": "quality_optimized",
  "instructions": "Match our standard NDA. Walk away on unlimited indemnity."
}

Required scope: legal:write. playbook_id must be a published position or template in the same region.

{
  "id": "rdl_4821",
  "object": "eridian.legal.redline",
  "status": "completed",
  "model": "gpt",
  "format": "docx",
  "change_count": 18,
  "walk_away_hits": [
    {
      "topic": "indemnity",
      "severity": "block",
      "citation": { "page": 6 }
    }
  ],
  "download_url": "https://api.geteridian.com/v1/legal/redlines/rdl_4821/content",
  "eridian": {
    "route": "gpt",
    "region": "me-central-1",
    "cost_usd": 0.19
  }
}

download_url is short-lived (15 minutes) and requires the same key. Formats: docx (default), pdf_annotated.

How markup is produced

1. Parse the draft if not already a contract object.
2. Compare against playbook clauses (Clause Extraction compare).
3. GPT (or Gemini if pinned) proposes replacement text.
4. A deterministic patcher applies tracked changes. If the patcher cannot place a span, the change is listed as unplaced and not silently dropped.

Unplaced changes must be resolved by counsel. Do not ship a redline with unplaced to a counterparty.

Confirm

POST /v1/legal/redlines/rdl_4821/confirm

{
  "approver_id": "usr_kadart",
  "comment": "Accepted all except assignment."
}

On Enterprise, confirm is dual-controlled when the playbook says high_risk: true (for example, data-transfer clauses). See Dual Control.

Iterate

POST /v1/legal/redlines/rdl_4821/revise

{
  "model": "gpt",
  "instructions": "Restore their assignment clause. Keep our cap."
}

Each revise is a new version. Prior DOCX remains downloadable until the retention clock.

See Legal Limits for page caps and Evaluations before you require redlines in the operating line.