# FillDraft

object type

One background wizard draft (🤖 — slice): YOUR text and/or documents in, a drafted sheet across EVERY page of the walk out — in the background (the assistant thinks at its highest effort; the machine polls every 8 s inside a 480 s wall). The sheet (pages · questions · advice · understood) is ABSENT until status ready; failReason is present on failed. DRAFTS ONLY — nothing is created or applied; you review every value. expiresAt = the draft's lifetime in epoch seconds (startedAt + 30 days).

## Fields

| Field | Type | Notes |
| --- | --- | --- |
| `id` | [ID](/types/#scalars) `ID!` | No further notes. |
| `sysId` | [String](/types/#scalars) `String!` | No further notes. |
| `type` | [String](/types/#scalars) `String!` | No further notes. |
| `caption` | [String](/types/#scalars) `String!` | No further notes. |
| `status` | [FillDraftStatus](/types/FillDraftStatus/) `FillDraftStatus!` | No further notes. |
| `parentId` | [ID](/types/#scalars) `ID!` | The drafting person (the draft is theirs alone). |
| `rootId` | [ID](/types/#scalars) `ID!` | No further notes. |
| `revision` | [ID](/types/#scalars) `ID!` | No further notes. |
| `revisionNum` | [Int](/types/#scalars) `Int!` | No further notes. |
| `createdAt` | [String](/types/#scalars) `String!` | No further notes. |
| `updatedAt` | [String](/types/#scalars) `String!` | No further notes. |
| `wizardType` | [String](/types/#scalars) `String!` | The wizard word the draft was asked for (Item · Location · …) — prompt context and the materials' walk-scope word. |
| `brief` | [String](/types/#scalars) `String!` | Your text ('' on a documents-only draft). |
| `materialIds` | [ID](/types/#scalars) `[ID!]!` | No further notes. |
| `pages` | [FillDraftPageSpec](/types/FillDraftPageSpec/) `[FillDraftPageSpec!]!` | The pages you sent, in walk order. |
| `filled` | [String](/types/#scalars) `String!` | What was already answered when you asked ('' on a fresh wizard). |
| `sheet` | [FillDraftSheetPage](/types/FillDraftSheetPage/) `[FillDraftSheetPage!]` | No further notes. |
| `questions` | [String](/types/#scalars) `[String!]` | At most 5 — where the materials disagree, or a required field has no support. |
| `advice` | [String](/types/#scalars) | No further notes. |
| `understood` | [String](/types/#scalars) | What the assistant said it understood (the echo rule) — present once the draft is ready. |
| `turnCount` | [Int](/types/#scalars) `Int!` | No further notes. |
| `summary` | [String](/types/#scalars) | what the assistant remembers of the conversation so far — the stored rolling summary; absent until the older turns fold (past 12 un-summarized turns). |
| `summarizedThroughSeq` | [Int](/types/#scalars) `Int!` | turns before this ordinal live inside the summary; from it on, they are composed verbatim. 0 until the first fold. |
| `activeTurnId` | [ID](/types/#scalars) | the message the assistant is answering right now — present only while a talk is in flight (status drafting). |
| `activeTurnStartedAt` | [String](/types/#scalars) | No further notes. |
| `failReason` | [String](/types/#scalars) | No further notes. |
| `sfExecutionArn` | [String](/types/#scalars) | No further notes. |
| `startRequestId` | [ID](/types/#scalars) `ID!` | No further notes. |
| `startedAt` | [String](/types/#scalars) `String!` | No further notes. |
| `readyAt` | [String](/types/#scalars) | No further notes. |
| `takenAt` | [String](/types/#scalars) | when the sheet was taken into the record the wizard created — present iff status taken (set once). |
| `takenRef` | [String](/types/#scalars) | the record the draft was taken into — its sysId (or its id) as the taker named it at the take; present only on a taken draft whose take named one (a plain take carries none). A reference, never resolved. |
| `expiresAt` | [Int](/types/#scalars) `Int!` | No further notes. |

## Used by

- [abandonFillDraft](/reference/work-and-notes/abandonFillDraft/)
- [fillDraft](/reference/reading-your-records/fillDraft/)
- [startFillDraft](/reference/work-and-notes/startFillDraft/)
- [takeFillDraft](/reference/work-and-notes/takeFillDraft/)