---
title: "Explain a clause with AI"
method: POST
path: "/drafts/{draft_id}/explain"
tags: ["draft"]
---

# Explain a clause with AI

`POST /drafts/{draft_id}/explain`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/drafts/{draft_id}/explain`
- Auth: HTTP bearer

A plain-English explanation of one paragraph of a draft, on the workspace's own language model key, labelled as information and not legal advice, citing the clause and, for YC's forms, YC's user guide first. A decision model guards it: an explanation that recommends a choice, says what to do or predicts the reader's outcome is withheld (`explanation` null, `withheld` true) and the decision recorded. Needs the language key and a decision model. Never offered to a signer.

## Path parameters

- `draft_id` string, required

## Request body

- object
  - `paragraph_id` string, required

## Response `200`

The result.

- object
  - `explanation` string, nullable, required
  - `model` string, nullable, required
  - `withheld` boolean, required
  - `citations` object[], required
    - `label` string, required
    - `url` string, nullable, required

## Other responses

- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)