---
title: "Run AI's checks on a draft"
method: POST
path: "/envelopes/{envelope_id}/checks/ask"
tags: ["envelope"]
---

# Run AI's checks on a draft

`POST /envelopes/{envelope_id}/checks/ask`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/envelopes/{envelope_id}/checks/ask`
- Auth: HTTP bearer

Where an owner turned on checking drafts with AI, the decision model answers five advisory questions about the draft's text and its signers' names and email domains, in one request: a signature block for each signer, blocks that name their signer, how many sign for each company, exhibits that aren't attached, and documents e-signature law excludes beyond the rules. Each answer is a decision with "Why?"; one worth a look never stops Send. The same draft is asked once.

## Path parameters

- `envelope_id` string, required

## Request body

- object

## Response `200`

The result.

- object
  - `envelope_id` string, required
  - `checks` object[], required
    - `id` string, required
    - `rule` string, required
    - `kind` 'block' | 'warn' | 'fact', required
    - `label` string, required
    - `detail` string, required
    - `page` integer, nullable, required
    - `source` string, nullable, required
    - `acknowledged` object, nullable, required
      - `name` string, required
      - `note` string, nullable, required
      - `at` string, date-time, required
  - `ran` string[], required
  - `open` integer, required
  - `summary` string, required
  - `advisory` object, required
    - `state` 'asked' | 'not_asked' | 'off' | 'ai_off' | 'no_model', required
    - `checks` string[], required
    - `items` object[], required
      - `decision_id` string, required
      - `check` string, required
      - `worth_a_look` boolean, required
      - `says` string, required
      - `band` 'high' | 'medium' | 'low', nullable, required
      - `status` string, 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)