> ## 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.

# Import into a task

> Import into a task: table rows (JSON/XLSX) or question answers (JSON). dry_run validates and returns normalized data plus errors without saving; otherwise it validates, submits to scoring, and records a new evaluation. Requires the edit role.



## OpenAPI

````yaml post /api/v1/v-ciso/organizations/{organizationid}/workflows/{workflowid}/tasks/{taskid}/import
openapi: 3.1.0
info:
  title: Aegister API
  version: 1.0.5
servers: []
security: []
paths:
  /api/v1/v-ciso/organizations/{organizationid}/workflows/{workflowid}/tasks/{taskid}/import:
    post:
      tags:
        - V-CISO • Workflows
      summary: >-
        Import into a task — table rows (JSON/XLSX) or question answers (JSON);
        dry_run to validate
      description: >-
        Submit answers for a task; type-aware on the task's `kind` (see
        `/spec`).


        **Table task** — `application/json` `{"rows":[{<col_id>: value}],
        "dry_run"?: bool}` (scripting) or a `multipart/form-data` `.xlsx` in the
        `file` field (GUI). Values may be the label or the value_id; multi-value
        as an array or `|`-joined.


        **Question task** — `application/json` `{"answers":{<question_id>:
        value}, "dry_run"?: bool}`. Choice answers accept the label or value id;
        multi as an array or comma/pipe-joined. To attach **evidence** or a
        **justification**, send a composite answer `{value, evidence:[<path>],
        note:[{id, response}]}` — upload the file first via `POST
        …/documents/<artifactId>/versions` and use the returned `path`.


        `dry_run` validates and returns the normalized payload + errors without
        writing; otherwise it validates then persists a new evaluation
        (Activepieces computes the score). Requires the `edit` role.
      operationId: v-ciso-task-import
      parameters:
        - in: query
          name: dry_run
          schema:
            type: boolean
          description: Validate only and return rows+errors without writing.
        - 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
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                rows:
                  type: array
                  items:
                    type: object
                    additionalProperties: true
                  description: table task rows
                answers:
                  type: object
                  additionalProperties: true
                  description: 'question task answers {question_id: value}'
                dry_run:
                  type: boolean
            examples:
              TableRows(dryRun):
                value:
                  dry_run: true
                  rows:
                    - asset_id: HW-001
                      device_input: Physical servers
                      criticality: High
                summary: Table rows (dry_run)
              QuestionAnswers(dryRun):
                value:
                  dry_run: true
                  answers:
                    task-nisAnnual-q1: 'Yes'
                summary: Question answers (dry_run)
              QuestionAnswerWithEvidence+Justification:
                value:
                  answers:
                    task-nisAnnual-q1:
                      value: 'Yes'
                      evidence:
                        - >-
                          media/docs/frameworks/65/oJJ.../task-nisAnnual-q1/tok_x.pdf
                      note:
                        - id: note-1
                          response: Notified ACN on 2026-01-10.
                summary: Question answer with evidence + justification
      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
                    description: >-
                      dry_run → {columns, rows, errors, valid_count,
                      error_count}; submit → {imported_rows, evaluation_id}
                    additionalProperties: true
          description: ''
        '400':
          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:
                      - - Invalid data provided
          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: ''
      security:
        - ApiKeyAuth: []
        - ApiKeyQueryParam: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Aegister-Token
    ApiKeyQueryParam:
      type: apiKey
      in: query
      name: X-Aegister-Token

````