---
title: "Docket Deadline Sweep"
method: POST
path: "/v1/tools/sweep_docket_deadlines"
tags: ["compliance_control", "legal-ops", "docket-deadlines", "mcp:sweep_docket_deadlines"]
---

# Docket Deadline Sweep

`POST /v1/tools/sweep_docket_deadlines`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/sweep_docket_deadlines`
- Auth: none declared

Sweeps a caller-declared docket -- a flat list of {date, action, type, source, done} deadline records, the structured shape practitioners already keep in a spreadsheet, calendar, or practice-management export -- against a caller-declared as-of date, and bands every record OVERDUE, DUE_SOON, SCHEDULED, DONE, or INDETERMINATE. Shows the weekend/holiday roll derivation step by step for each record's actual due date, using roll rules (roll_weekends, roll_direction, holiday_dates) that are always declared caller inputs with labeled defaults, never an encoded jurisdiction rules table -- baking one in would be a standing-data-duty trap and UPL-adjacent. FRCP 6(a)(1)(C) is cited in-page only as a dated, structural EXAMPLE of what a roll rule looks like, never as an encoded ruleset for any jurisdiction. A record marked done:true is retained and reported DONE, never dropped -- the sweep is a receipt over the full declared docket at one as-of moment, not a filtered view of what remains open. Flags any two records that declare the same action on different dates as a conflict worth a human look. The due-soon banding threshold is a declared input with a labeled default (7 days). Gate policy is review_required when any record is OVERDUE or INDETERMINATE or a conflict exists, otherwise auto_pass; did_not_run when the as-of date, the sweep's own anchor, is absent -- it is never defaulted. Not legal advice, not a calendaring system of record, and not a reminder or scheduling service. Attribution: deadline-record shape design borrow from CounselOS's structured deadline tracker (eigenlegal/counsel-os, MIT).

**Tool URL:** https://ainumbers.co/chaingraph/art-588-docket-deadline-sweep.html

## Request body

- object
  - `as_of_date` unknown, required
  - `due_soon_days_threshold` number, required
  - `records` unknown[], required
    - unknown
  - `roll_rule` unknown, required

## Response `200`

Successful tool execution result

- object
  - `decision` object
    - `gate_policy` string
    - `execution_state` string
    - `reason` string
  - `as_of_date` string
  - `due_soon_days_threshold` integer
  - `due_soon_days_threshold_is_default` boolean
  - `roll_rule` object
    - `roll_weekends` boolean
    - `roll_weekends_is_default` boolean
    - `roll_direction` string
    - `roll_direction_is_default` boolean
    - `holiday_dates` unknown[]
      - unknown
  - `record_count` integer
  - `records` object[]
    - `record_id` string
    - `date` string
    - `action` string
    - `type` string
    - `source` string
    - `done` boolean
    - `status` string
    - `rolled_date` string
    - `days_remaining` integer
    - `roll` object
  - `conflicts` object[]
    - `action` string
    - `record_ids` unknown[]
      - unknown
    - `dates` unknown[]
      - unknown
  - `sweep_summary` object
  - `rejected_inputs` unknown[]
    - unknown
  - `scope_note` string
  - `clause_note` string
  - `not_legal_advice_note` string

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)
