AlmondTill/G3N API

On this page

fillDraft

query · in the family Reading your records

What it does

Look up one of your own wizard drafts — its status, the sheet page by page once it is ready, the questions the assistant asked, and why it stopped if it failed.

Read ONE of YOUR wizard drafts: its status, the sheet page by page once ready (each value with its source and confidence), the assistant's questions and advice, what it said it understood, and failReason when it failed. YOURS ALONE: another person's draft, a draft outside your tenant, or none at all is NOT_FOUND. Requires authentication (user sessions).

What happens

Reads only — changes nothing. Another person’s draft is not yours to read.

Who may call it

Capability area: Reading your records — Looking up and listing the records of your organization.

Arguments

NameTypeRequiredNotes
idID ID!yesThe id of the record.

Returns

FillDraft FillDraft! — 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).

Example request

query ExampleFillDraft($id: ID!) {
  fillDraft(id: $id) {
    id
    sysId
    type
    caption
    status
    parentId
    rootId
    revision
    revisionNum
    createdAt
    updatedAt
    wizardType
    brief
    materialIds
    filled
    questions
    advice
    understood
    turnCount
    summary
    summarizedThroughSeq
    activeTurnId
    activeTurnStartedAt
    failReason
    sfExecutionArn
    startRequestId
    startedAt
    readyAt
    takenAt
    takenRef
    expiresAt
  }
}

Variables:

{
  "id": "01900000-0000-7000-8000-37386ae00000"
}

Example response

{
  "data": {
    "fillDraft": {
      "id": "01900000-0000-7000-8000-37386ae00000",
      "sysId": "FL-EXMP-0000-000F",
      "type": "FillDraft",
      "caption": "Blue jeans",
      "status": "drafting",
      "parentId": "01900000-0000-7000-8000-065235280000",
      "rootId": "01900000-0000-7000-8000-a093dd800000",
      "revision": "01900000-0000-7000-8000-b7960e180000",
      "revisionNum": 1,
      "createdAt": "2027-01-31T00:00:00.000Z",
      "updatedAt": "2027-01-31T00:00:00.000Z",
      "wizardType": "<wizard type>",
      "brief": "<brief>",
      "materialIds": [
        "01900000-0000-7000-8000-a36392ca0000"
      ],
      "filled": "<filled>",
      "questions": [
        "<questions>"
      ],
      "advice": "<advice>",
      "understood": "<understood>",
      "turnCount": 1,
      "summary": "<summary>",
      "summarizedThroughSeq": 1,
      "activeTurnId": "01900000-0000-7000-8000-770cb7810000",
      "activeTurnStartedAt": "2027-01-31T00:00:00.000Z",
      "failReason": "<fail reason>",
      "sfExecutionArn": "<sf execution arn>",
      "startRequestId": "01900000-0000-7000-8000-c154ec1d0000",
      "startedAt": "2027-01-31T00:00:00.000Z",
      "readyAt": "2027-01-31T00:00:00.000Z",
      "takenAt": "2027-01-31T00:00:00.000Z",
      "takenRef": "<taken ref>",
      "expiresAt": 1
    }
  },
  "extensions": {
    "at": {
      "callId": "01EXAMPLE-CALL-ID",
      "version": {
        "requested": null,
        "serviced": {
          "name": "genesis",
          "number": 0
        }
      }
    }
  }
}

Errors this call can answer