Briefs

Queue a brief

Requires the briefs scope. Queues a brief on a matter against a live expert class and answers 202 at once; poll GET /briefs/{id} or listen for the brief.completed webhook. Credits are charged when the brief is delivered, never for a brief that fails. The balance is checked before queueing.

side, when given, must agree with the side the expert class models. With a test key the brief is finished on arrival with a sample result and nothing is charged.

A report analyzed on the matter (POST /reports/analyze, or in the app) is read by every brief on it. use_matter_target_report: true makes that explicit, pins the report as it stands now onto this brief, and refuses the brief (no_target_report) when the matter has none. Send it or target_report, not both.

holdout is for evaluation. It names up to 20 cases (typically the ruling a benchmark will score this brief against, and its appeals) that the brief must not read: they are withheld from every source the brief draws on, and the result reports what was withheld under result.holdout. It binds this brief only and does not change the matter.

post/briefs

Request

  • Base URL: https://api.suprememind.ai/v1
  • URL: https://api.suprememind.ai/v1/briefs
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Makes a POST safe to retry for 24 hours.

Request body

matter_idstring required
expert_classstring required

An id from GET /expert-classes.

side'plaintiff' | 'defense' | 'either'
profile'standard' | 'high'

Defaults to the firm's setting. high costs two credits where it runs a distinct model.

target_reportobject

A structured summary of an opposing (or your own) expert report to aim the cross-examination and methodology sections at.

use_matter_target_reportboolean

Aim the brief at the report already analyzed on the matter.

Response

The brief was queued (or, for a test key, finished).

idstring required
object'brief' required
livemodeboolean
status'queued' | 'succeeded' required
matter_idstring
expert_classstring
created_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.