> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aegister.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get the AI fill proposal for a V-CISO task

> Poll a fill job: `status: running` while the AI reads, then the proposal. For a table, `rows` are ready for “Import task”; for questions, `answers` keyed by question id. `ai` explains it: a summary, how many items were filled, the confidence and source document of each answer, and the rows left out with the reason. A `msg` instead means the documents hold nothing for the task. Only the person who started the job can read it.



## OpenAPI

````yaml get /api/v1/v-ciso/organizations/{organizationid}/workflows/{workflowid}/tasks/{taskid}/prefill/{job}
openapi: 3.1.0
info:
  title: Aegister API
  version: 2.10.0
servers: []
security: []
paths:
  /api/v1/v-ciso/organizations/{organizationid}/workflows/{workflowid}/tasks/{taskid}/prefill/{job}:
    get:
      tags:
        - V-CISO • Workflows
      summary: 'Fill a task from documents (AI): the proposal'
      description: >-
        `{status: "running"}` while the AI reads; then the proposal: `responses`
        in the shape the console saves, `answers` (questions) or `rows` (tables)
        to show, and `ai` (summary, filled/total, per answer the confidence and
        the source, rows left out, items missing from linked lists). `{msg}`
        when the documents hold nothing for the task. Only the person who
        started the job reads it, once: the result is then deleted at OpenAI.
      operationId: v-ciso-task-prefill-result
      parameters:
        - in: path
          name: job
          schema:
            type: string
          required: true
        - in: query
          name: lan
          schema:
            type: string
          description: Language for labels/validation (en|it).
        - in: path
          name: organizationid
          schema:
            type: integer
          required: true
        - in: path
          name: taskid
          schema:
            type: string
          required: true
        - in: path
          name: workflowid
          schema:
            type: string
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: integer
                    description: |-
                      Any value different from 0 indicates an error.  
                      More details can be found in `messages`.
                    minimum: 0
                    maximum: 0
                    examples:
                      - 0
                  messages:
                    type: array
                    description: >-
                      If `error` is `1`, contains zero or more details on the
                      error.
                    examples:
                      - []
                  data:
                    type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - running
                          - done
                        description: Only `status` while the AI reads.
                      kind:
                        type: string
                        enum:
                          - questions
                          - table
                      msg:
                        type: string
                        description: >-
                          Instead of a proposal, when the documents hold nothing
                          for the task.
                      responses:
                        type: array
                        items:
                          type: object
                        description: >-
                          The answers in the shape the console saves: questions
                          `{id, response, evidence}`, table rows by column id.
                      answers:
                        type: object
                        additionalProperties: true
                        description: 'Questions: {question id: value or [values]} to show.'
                      columns:
                        type: array
                        items:
                          type: object
                        description: 'Tables: the columns of the task spec.'
                      rows:
                        type: array
                        items:
                          type: object
                        description: 'Tables: the rows as POST …/import takes them.'
                      current:
                        type: array
                        items:
                          type: object
                        description: 'Tables: the rows the table holds now.'
                      ai:
                        type: object
                        properties:
                          summary:
                            type: string
                          filled:
                            type: integer
                          total:
                            type: integer
                            nullable: true
                            description: Questions asked; null for tables.
                          existing:
                            type: integer
                            description: 'Questions: saved answers kept as they are.'
                          replaced_rows:
                            type: integer
                            description: 'Tables: rows the import would replace.'
                          details:
                            type: array
                            items:
                              type: object
                              description: >-
                                One answer (questions) or row (tables) the AI
                                proposes or could not use.
                              properties:
                                id:
                                  type: string
                                  description: Question id (questions).
                                label:
                                  type: string
                                status:
                                  type: string
                                  enum:
                                    - filled
                                    - not_found
                                    - invalid
                                  description: Questions.
                                answer:
                                  type: string
                                  description: >-
                                    The proposed answer as the client reads it,
                                    a choice by its label.
                                reason:
                                  type: string
                                  nullable: true
                                  description: Why it is not proposed.
                                row:
                                  type: integer
                                  description: Position in `rows` (tables).
                                ai_row:
                                  type: integer
                                  description: Position in the AI answer (tables).
                                problems:
                                  type: array
                                  items:
                                    type: string
                                  description: Values dropped from the row (tables).
                                confidence:
                                  type: string
                                  enum:
                                    - high
                                    - medium
                                    - low
                                  nullable: true
                                source:
                                  type: string
                                  nullable: true
                                  description: Where in the documents the AI found it.
                          skipped_rows:
                            type: array
                            items:
                              type: object
                              description: >-
                                One answer (questions) or row (tables) the AI
                                proposes or could not use.
                              properties:
                                id:
                                  type: string
                                  description: Question id (questions).
                                label:
                                  type: string
                                status:
                                  type: string
                                  enum:
                                    - filled
                                    - not_found
                                    - invalid
                                  description: Questions.
                                answer:
                                  type: string
                                  description: >-
                                    The proposed answer as the client reads it,
                                    a choice by its label.
                                reason:
                                  type: string
                                  nullable: true
                                  description: Why it is not proposed.
                                row:
                                  type: integer
                                  description: Position in `rows` (tables).
                                ai_row:
                                  type: integer
                                  description: Position in the AI answer (tables).
                                problems:
                                  type: array
                                  items:
                                    type: string
                                  description: Values dropped from the row (tables).
                                confidence:
                                  type: string
                                  enum:
                                    - high
                                    - medium
                                    - low
                                  nullable: true
                                source:
                                  type: string
                                  nullable: true
                                  description: Where in the documents the AI found it.
                            description: 'Tables: rows left out, with the reason.'
                          linked:
                            type: array
                            description: >-
                              Items the documents name that are missing from the
                              list a column takes its choices from.
                            items:
                              type: object
                              properties:
                                source:
                                  type: string
                                missing:
                                  type: array
                                  items:
                                    type: string
                                empty_list:
                                  type: boolean
                                message:
                                  type: string
                          documents:
                            type: object
                            description: >-
                              The documents read and those left out, with the
                              reason.
                            properties:
                              used:
                                type: array
                                items:
                                  type: string
                              skipped:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    name:
                                      type: string
                                    reason:
                                      type: string
          description: ''
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: integer
                    description: |-
                      Any value different from 0 indicates an error.  
                      More details can be found in `messages`.
                    minimum: 0
                    maximum: 0
                    examples:
                      - 1
                  messages:
                    type: array
                    description: >-
                      If `error` is `1`, contains zero or more details on the
                      error.
                    examples:
                      - - 9153
          description: ''
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: integer
                    description: |-
                      Any value different from 0 indicates an error.  
                      More details can be found in `messages`.
                    minimum: 0
                    maximum: 0
                    examples:
                      - 1
                  messages:
                    type: array
                    description: >-
                      If `error` is `1`, contains zero or more details on the
                      error.
                    examples:
                      - []
          description: ''
        '502':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: integer
                    description: |-
                      Any value different from 0 indicates an error.  
                      More details can be found in `messages`.
                    minimum: 0
                    maximum: 0
                    examples:
                      - 1
                  messages:
                    type: array
                    description: >-
                      If `error` is `1`, contains zero or more details on the
                      error.
                    examples:
                      - []
          description: ''
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Aegister-Token

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.