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

# Start the next ACN filing of an incident

> Start the next filing (`notifica`, `intermedia` or `finale`) once the previous one was sent to ACN. The new filing starts from the values of the last one sent, so you only change what is new. Owners and security officers.



## OpenAPI

````yaml post /api/v1/v-ciso/incidents/{organizationid}/{incidentid}/filings
openapi: 3.1.0
info:
  title: Aegister API
  version: 2.10.0
servers: []
security: []
paths:
  /api/v1/v-ciso/incidents/{organizationid}/{incidentid}/filings:
    post:
      tags:
        - v-ciso
      summary: Start the next filing
      description: Start the next filing from the last one sent to ACN.
      operationId: v_ciso_incidents_filings_create
      parameters:
        - in: path
          name: incidentid
          schema:
            type: integer
          required: true
        - in: path
          name: organizationid
          schema:
            type: integer
          required: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FilingCreate'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/FilingCreate'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/FilingCreate'
        required: true
      responses:
        '201':
          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: >-
                      A filing to the ACN portal. `values` and `sources` are
                      keyed by the portal's field ids (see the form schema).
                    properties:
                      id:
                        type: integer
                      kind:
                        type: string
                        enum:
                          - prenotifica
                          - notifica
                          - intermedia
                          - finale
                      values:
                        type: object
                        additionalProperties: true
                        description: >-
                          {portal field id: value}: a string, number or boolean,
                          a list of strings (multiselect, checklist, tags) or,
                          for `indicators`, a list of {kind: IoC|IoA, type,
                          value, description}. The form schema gives each
                          field's type and choices.
                      sources:
                        type: object
                        additionalProperties:
                          type: string
                          enum:
                            - ai
                            - user
                            - org
                        description: >-
                          Who filled each field: the AI draft, a person or the
                          organization profile.
                      schema_version:
                        type: string
                        description: Version of the ACN form the values follow.
                      based_on:
                        type: integer
                        nullable: true
                        description: The filing this one started from.
                      filed_at:
                        type: string
                        format: date-time
                        nullable: true
                        description: >-
                          When it was sent on the portal; the filing is locked
                          from then on.
                      csirt_protocol:
                        type: string
                      filed_by:
                        type: string
                      created_at:
                        type: string
                        format: date-time
                      updated_at:
                        type: string
                        format: date-time
                      readiness:
                        type: object
                        description: >-
                          What the filing still needs before it can go to the
                          portal, as the portal would judge it.
                        properties:
                          missing:
                            type: array
                            items:
                              type: string
                            description: >-
                              Required fields shown for this filing and still
                              empty, by portal field id.
                          rules:
                            type: array
                            items:
                              type: object
                              properties:
                                field:
                                  type: string
                                  description: Portal field id.
                                rule:
                                  type: string
                                  enum:
                                    - one_predicate
                                    - all_predicates
                                    - required_predicates
                                    - portal_host
                                    - is4_essential_only
                                ok:
                                  type: boolean
                                missing_predicates:
                                  type: array
                                  items:
                                    type: string
                                  description: >-
                                    Taxonomy predicates still to pick; for
                                    `portal_host`, the indicators the portal
                                    refuses (a domain without a host part).
                          filled:
                            type: integer
                            description: Fields shown for this filing that hold a value.
                          total:
                            type: integer
                            description: Fields shown for this filing.
                          ready:
                            type: boolean
                            description: Nothing missing and every rule met.
          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:
                      - []
          description: ''
        '403':
          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:
  schemas:
    FilingCreate:
      type: object
      properties:
        kind:
          $ref: '#/components/schemas/KindEnum'
      required:
        - kind
    KindEnum:
      enum:
        - notifica
        - intermedia
        - finale
      type: string
      description: |-
        * `notifica` - notifica
        * `intermedia` - intermedia
        * `finale` - finale
  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.