openapi: 3.0.0
info:
  title: Bewerking API voor logging van verwerkingen
  description: API-specificatie voor gemeenten ten behoeve van de registratie en ontsluiting van de metagegevens behorende bij de verwerkingen van (persoons)gegevens. Deze Bewerking API is bedoeld voor gebruik binnen de gemeente of samenwerkingsverband.
  contact:
    url: https://vng-realisatie.github.io/gemma-verwerkingenlogging/api-write/index
    email: standaarden.ondersteuning@vng.nl
  license:
    name: EUPL 1.2
    url: https://opensource.org/licenses/EUPL-1.2
  version: 0.9.0
security: 
  - JWT-Claims: []
paths:
  /verwerkingsacties:
    get:
      tags:
        - verwerkingsacties
      summary: Verwerkingsacties opvragen.
      operationId: verwerkingsactie_list
      description: Door de juiste parameters mee te geven kun je zoeken naar de voor jouw relevante verwerkingsacties.
      parameters:
        - name: objecttype
          in: query
          description: Soort object dat bij de verwerkingsactie betrokken is.
          required: true
          schema:
            type: string
            enum:
              - persoon
          example: persoon
        - name: soortObjectId
          in: query
          description: Soort identificator waarmee het object geïdentificeerd wordt.
          required: true
          schema:
            type: string
            format: naam
            maxLength: 242
            example: BSN
        - name: objectId
          in: query
          description: Identificator van het object.
          required: true
          schema:
            type: string
            format: identificator
            maxLength: 40
            example: "479580261"
        - name: beginDatum
          in: query
          description: Datum van de verwerkingsactie moet groter of gelijk zijn aan deze datum om teruggegeven te worden.
          # required: true
          schema:
            type: string
            format: date
            example: "2020-10-24"
        - name: eindDatum
          in: query
          description: Datum van de verwerkingsactie moet kleiner zijn dan deze datum om teruggegeven te worden.
          # required: true
          schema:
            type: string
            format: date
            example: "2020-11-24"
        - name: vertrouwelijkheid
          in: query
          description: Geeft de mate van vertrouwelijkheid van de verwerking aan. Je kunt meerdere waarden tegelijk opgeven.
          schema:
            type: array
            items:
              $ref: '#/components/schemas/VertrouwelijkheidEnum'
        # - name: beperkteSet
        #   in: query
        #   description: In geval van 'true' worden niet alle attributen teruggegeven. Bijvoorbeeld attributen zoals 'gebruiker', 'gegevensbron' en 'systeem'  zijn niet relevant voor burgers. In geval van 'false' worden alle velden teruggegeven in het resultaat.
        #   schema:
        #     type: boolean
        #     default: true
        - name: verwerkingsactiviteitId
          in: query
          description: Identificator van de verwerkingsactiviteit die de verwerking rechtvaardigt.
          schema:
            type: string
            format: uuid
          example: "5f0bef4c-f66f-4311-84a5-19e8bf359eaf"
      responses:
        '200':
          description: OK
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/json:
              schema:
                required:
                - count
                - results
                type: object
                properties:
                  count:
                    type: integer
                  next:
                    type: string
                    format: uri
                    nullable: true
                  previous:
                    type: string
                    format: uri
                    nullable: true
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/VerwerkingsactieUitgebreid'
        '400':
          description: Bad request
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ValidatieFout'
        '401':
          description: Unauthorized
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '403':
          description: Forbidden
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '406':
          description: Not acceptable
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '409':
          description: Conflict
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '410':
          description: Gone
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '415':
          description: Unsupported media type
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '429':
          description: Too many requests
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '500':
          description: Internal server error
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '501':
          description: Not Implemented
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '503':
          description: Service Unavailable
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
      security: 
      - JWT-Claims:
        - read:normal
        - read:confidential
    post:
      tags:
        - verwerkingsacties
      summary: Maak een verwerkingsactie aan.
      operationId: verwerkingsactie_create
      description: Maak een verwerkingsactie aan.
      requestBody:
        $ref: '#/components/requestBodies/VerwerkingsactieUitgebreidBasis'
      responses:
        '201':
          description: Created
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
            Location:
              schema:
                type: string
                format: uri
              description: URL waar de resource leeft.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerwerkingsactieUitgebreid'
        '400':
          description: Bad request
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ValidatieFout'
        '401':
          description: Unauthorized
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '403':
          description: Forbidden
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '406':
          description: Not acceptable
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '409':
          description: Conflict
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '410':
          description: Gone
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '415':
          description: Unsupported media type
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '429':
          description: Too many requests
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '500':
          description: Internal server error
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '501':
          description: Not Implemented
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '503':
          description: Service Unavailable
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
      security: 
      - JWT-Claims:
        - create:normal
        - create:confidential
    patch:
      tags:
        - verwerkingsacties
      summary: Wijzig de verwerkingsacties gedeeltelijk.
      operationId: verwerkingsactie_list_patch
      description: Wijzigt de bewaartermijn of vertrouwelijkheid van alle verwerkingsacties die in het kader van de opgegeven verwerking gelogd zijn. Om de vertrouwelijkheid te wijzigen zijn `update:confidential` rechten nodig.
      parameters:
        - name: verwerkingId
          in: query
          description: Identificator van de verwerking waar de handeling een onderdeel van is.
          required: true
          schema:
            type: string
            format: uuid
          example: "48086bf2-11b7-4603-9526-67d7c3bb6587"
      requestBody:
        $ref: '#/components/requestBodies/PatchRequestBody'
      responses:
        '204':
          description: No content
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
        '400':
          description: Bad request
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ValidatieFout'
        '401':
          description: Unauthorized
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '403':
          description: Forbidden
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '404':
          description: Not found
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '406':
          description: Not acceptable
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '409':
          description: Conflict
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '410':
          description: Gone
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '415':
          description: Unsupported media type
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '429':
          description: Too many requests
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '500':
          description: Internal server error
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '501':
          description: Not Implemented
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '503':
          description: Service Unavailable
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
      security: 
      - JWT-Claims:
        - update:normal
        - update:confidential
  /verwerkingsacties/{actieId}:
    get:
      tags:
        - verwerkingsacties
      operationId: verwerkingsactie_read
      summary: Een specifieke verwerkingsactie opvragen.
      description: Een specifieke verwerkingsactie opvragen.
      responses:
        '200':
          description: OK
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerwerkingsactieUitgebreid'
        '400':
          description: Bad request
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ValidatieFout'
        '401':
          description: Unauthorized
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '403':
          description: Forbidden
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '404':
          description: Not found
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '406':
          description: Not acceptable
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '409':
          description: Conflict
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '410':
          description: Gone
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '412':
          description: Precondition failed
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van een
                specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '415':
          description: Unsupported media type
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '429':
          description: Too many requests
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '500':
          description: Internal server error
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '501':
          description: Not Implemented
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '503':
          description: Service Unavailable
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
      security: 
      - JWT-Claims:
        - read:normal
        - read:confidential
    put:
      tags:
        - verwerkingsacties
      operationId: verwerkingsactie_update
      summary: Wijzig een verwerkingsactie.
      description: Wijzigt een bestaande verwerkingsactie in het log. Alle informatie over de verwerkingsactie moet opnieuw meegegeven worden, ook de informatie die niet wijzigt.
      requestBody:
        $ref: '#/components/requestBodies/VerwerkingsactieUitgebreid'
      responses:
        '200':
          description: OK
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerwerkingsactieUitgebreid'
        '400':
          description: Bad request
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ValidatieFout'
        '401':
          description: Unauthorized
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '403':
          description: Forbidden
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '404':
          description: Not found
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '406':
          description: Not acceptable
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '409':
          description: Conflict
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '410':
          description: Gone
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '415':
          description: Unsupported media type
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '429':
          description: Too many requests
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '500':
          description: Internal server error
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '501':
          description: Not Implemented
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '503':
          description: Service Unavailable
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
      security: 
      - JWT-Claims:
        - update:normal
        - update:confidential
    delete:
      tags:
        - verwerkingsacties
      operationId: verwerkingsactie_delete
      summary: Verwijder een verwerkingsactie.
      description: De opgegeven verwerkingsactie wordt gemarkeerd als vervallen. Hierdoor zal deze niet meer geretourneerd worden door de inzage-functies van de logging API.
      responses:
        '204':
          description: No content
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
        '401':
          description: Unauthorized
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '403':
          description: Forbidden
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '404':
          description: Not found
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '406':
          description: Not acceptable
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '409':
          description: Conflict
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '410':
          description: Gone
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '415':
          description: Unsupported media type
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '429':
          description: Too many requests
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '500':
          description: Internal server error
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '501':
          description: Not Implemented
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
        '503':
          description: Service Unavailable
          headers:
            API-version:
              schema:
                type: string
              description: 'Geeft een specifieke API-versie aan in de context van
                een specifieke aanroep. Voorbeeld: 1.2.1.'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Fout'
      security: 
      - JWT-Claims:
        - delete:normal 
        - delete:confidential
    parameters:
    - name: actieId
      in: path
      description: Identificator die de verwerkingsactie uniek identificeert (UUID4).
      required: true
      schema:
        type: string
        format: uuid
        example: "7a22eb38-bca6-463f-9955-54ab040287cb"
components:
  requestBodies:
    Verwerkingsactie:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Verwerkingsactie'
      required: true
    VerwerkingsactieUitgebreid:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/VerwerkingsactieUitgebreid'
      required: true
    VerwerkingsactieUitgebreidBasis:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/VerwerkingsactieUitgebreidBasis'
      required: true
    PatchRequestBody:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PatchRequestBody'
      required: true
  securitySchemes:
    JWT-Claims:
      type: http
      scheme: bearer
      bearerFormat: JWT
  schemas:
    Verwerkingsactie:
      title: Verwerkingsactie
      description: Een verwerkingsactie is een operatie die wordt uitgevoerd door een geautomatiseerd systeem waarbij er (persoons)gegevens verwerkt worden. Een verwerkingsactie wordt uitgevoerd als onderdeel van (een handeling van) een verwerking.
      type: object
      required:
        - url
        - actieId
        - vertrouwelijkheid
        - tijdstip
        - tijdstipRegistratie
        - verwerkteObjecten
      properties:
        url:
          title: URL
          description: URL-referentie naar deze resource. Deze link wordt automatisch aangemaakt.
          type: string
          format: uri
          maxLength: 2042
          minLength: 1
          readOnly: true
          example: "https://verwerkingenlogging-bewerking-api.vng.cloud/api/v1/verwerkingsacties/7a22eb38-bca6-463f-9955-54ab040287cb"
        actieId:
          title: Actie ID
          description: Identificator van de verwerkingsactie waar de persoon of het object bij betrokken is. Deze ID wordt automatisch aangemaakt door het log.
          type: string
          format: uuid
          readOnly: true
          example: "7a22eb38-bca6-463f-9955-54ab040287cb"
        actieNaam:
          title: Actie Naam
          description: Naam van de verwerkingsactie.
          type: string
          maxLength: 242
          example: Zoeken personen
        handelingNaam:
          title: Handeling Naam
          description:  Naam van de handeling waar de verwerkingsactie onderdeel van is.
          type: string
          maxLength: 242
          example: Intake
        verwerkingNaam:
          title: Verwerking Naam
          description:  Naam van de verwerking waar de handeling een onderdeel van is.
          type: string
          maxLength: 242
          example: Huwelijk
        verwerkingId:
          title: Verwerking ID
          description: Identificator van de verwerking waar de handeling een onderdeel van is.
          type: string
          format: uuid
          example: "48086bf2-11b7-4603-9526-67d7c3bb6587"    
        verwerkingsactiviteitId:
          title: Verwerkingsactiviteit ID
          description: Identificator van de verwerkingsactiviteit die de verwerking rechtvaardigt.
          type: string
          format: uuid
          example: "5f0bef4c-f66f-4311-84a5-19e8bf359eaf"
        verwerkingsactiviteitUrl:
          title: Verwerkingsactiviteit URL
          description: URL-referentie naar de verwerkingsactiviteit.
          type: string
          format: uri
          maxLength: 2042
          example: "https://verwerkingsactiviteiten-api.vng.cloud/api/v1/verwerkingsactiviteiten/5f0bef4c-f66f-4311-84a5-19e8bf359eaf"
        vertrouwelijkheid:
          title: Vertrouwelijkheid
          description: Geeft de mate van vertrouwelijkheid van de verwerking aan.
          type: string
          enum:
            - normaal
            - vertrouwelijk
            - opgeheven
          default: normaal
          example: normaal
        bewaartermijn:
          title: Bewaartermijn
          description: Periode waarin de verwerking bewaard moet blijven.
          type: string
          format: duration
          example: P10Y
        uitvoerder:
          title: Uitvoerder
          description: Organisatie in OIN-formaat die de verwerking uitgevoerd heeft. Voor een beschrijving van het OIN-formaat Zie https://www.logius.nl/diensten/digikoppeling/documentatie in bijlage A van het document ‘Digikoppeling Identificatie en Authenticatie’.
          type: string
          pattern: '[0-9]{20}'
          example: "00000001821002193000"
        systeem:
          title: Systeem
          description: Het systeem dat de verwerkingsactie heeft uitgevoerd.
          type: string
          maxLength: 242
          example: "FooBarApp v2.1"
        gebruiker:
          title: Gebruiker
          description: Identificator van de gebruiker die de verwerkingsactie heeft geïnitieerd.
          type: string
          format: identificator
          maxLength: 40
          example: "123456789"
        gegevensbron:
          title: Gegevensbron
          description: Gegevensbron waarin de bij verwerkingsactie betrokken gegevens zijn opgeslagen.
          type: string
          maxLength: 242
          example: FooBar Database Publiekszaken
        soortAfnemerId:
          title: Soort afnemer ID
          description: Soort identificator waarmee de afnemer geïdentificeerd wordt.
          type: string
          maxLength: 242
          example: OIN
        afnemerId:
          title: Afnemer ID
          description: Bij levering van gegevens moet hier de identificator opgenomen worden van de organisatie die de gegevens ontvangt. Het attribuut Soort afnemer ID) bepaalt wat voor soort identificator gebruikt wordt om de afnemer te identificeren. Op dit moment kan gekozen worden uit een OIN voor organisaties en een BSN voor natuurlijke personen.
          type: string
          format: OIN
          maxLength: 40
          example: "00000001821002193000"
        verwerkingsactiviteitIdAfnemer:
          title: Verwerkingsactiviteit ID Afnemer
          description: Identificator van de verwerkingsactiviteit aan de kant van de afnemer. 
          type: string
          format: uuid
          example: "c5b9f4e7-8c79-41b9-91e2-6268419cb167"
        verwerkingsactiviteitUrlAfnemer:
          title: Verwerkingsactiviteit URL Afnemer
          description: URL-referentie naar de verwerkingsactiviteit van de afnemer.
          type: string
          format: uri
          maxLength: 2042
          example: "https://www.amsterdam.nl/var/api/v1/verwerkingsactiviteiten/5f0bef4c-f66f-4311-84a5-19e8bf359eaf"
        verwerkingIdAfnemer:
          title: Verwerking ID Afnemer
          description: Identificator van de verwerking aan de kant van de afnemer.
          type: string
          format: uuid
          example: "4b698de3-ffba-45e7-8697-a283ec863db2"
        tijdstip:
          title: Tijdstip
          description: Tijdstip waarop de verwerkingsactie is uitgevoerd.
          type: string
          format: date-time
          example: '2024-04-05T14:35:42+01:00'
        tijdstipRegistratie:
          title: Tijdstip Registratie
          description: Tijdstip waarop de verwerkingsactie in het log is geregistreerd. Wordt bepaald door het log. Niet door het loggende systeem.
          type: string
          format: date-time
          readOnly: true
          example: '2024-04-05T14:35:42+01:00'
    VerwerkingsactieUitgebreid:
      title: Verwerkingsactie uitgebreid
      allOf:
        - $ref: '#/components/schemas/Verwerkingsactie'
        - type: object
          required:
            - verwerkteObjecten
          properties:
            verwerkteObjecten:
              title: Verwerkte objecten
              type: array
              items: 
                $ref: '#/components/schemas/VerwerktObject'
    VerwerkingsactieUitgebreidBasis:
      title: Verwerkingsactie uitgebreid
      allOf:
        - $ref: '#/components/schemas/Verwerkingsactie'
        - type: object
          required:
            - verwerkteObjecten
          properties:
            verwerkteObjecten:
              title: Verwerkte objecten
              type: array
              items: 
                $ref: '#/components/schemas/VerwerktObjectBasis'
    Fout:
      required:
      - code
      - title
      - status
      - detail
      - instance
      type: object
      properties:
        type:
          title: Type
          description: URI referentie naar het type fout, bedoeld voor developers
          type: string
        code:
          title: Code
          description: Systeemcode die het type fout aangeeft
          type: string
          minLength: 1
        title:
          title: Title
          description: Generieke titel voor het type fout
          type: string
          minLength: 1
        status:
          title: Status
          description: De HTTP status code
          type: integer
        detail:
          title: Detail
          description: Extra informatie bij de fout, indien beschikbaar
          type: string
          minLength: 1
        instance:
          title: Instance
          description: URI met referentie naar dit specifiek voorkomen van de fout.
            Deze kan gebruikt worden in combinatie met server logs, bijvoorbeeld.
          type: string
          minLength: 1
    FieldValidationError:
      required:
      - name
      - code
      - reason
      type: object
      properties:
        name:
          title: Name
          description: Naam van het veld met ongeldige gegevens
          type: string
          minLength: 1
        code:
          title: Code
          description: Systeemcode die het type fout aangeeft
          type: string
          minLength: 1
        reason:
          title: Reason
          description: Uitleg wat er precies fout is met de gegevens
          type: string
          minLength: 1
    ValidatieFout:
      required:
      - code
      - title
      - status
      - detail
      - instance
      - invalidParams
      type: object
      properties:
        type:
          title: Type
          description: URI referentie naar het type fout, bedoeld voor developers
          type: string
        code:
          title: Code
          description: Systeemcode die het type fout aangeeft
          type: string
          minLength: 1
        title:
          title: Title
          description: Generieke titel voor het type fout
          type: string
          minLength: 1
        status:
          title: Status
          description: De HTTP status code
          type: integer
        detail:
          title: Detail
          description: Extra informatie bij de fout, indien beschikbaar
          type: string
          minLength: 1
        instance:
          title: Instance
          description: URI met referentie naar dit specifiek voorkomen van de fout.
            Deze kan gebruikt worden in combinatie met server logs, bijvoorbeeld.
          type: string
          minLength: 1
        invalidParams:
          type: array
          items:
            $ref: '#/components/schemas/FieldValidationError'
    VertrouwelijkheidEnum:
      title: Enumeratie voor vertrouwelijkheid
      type: string
      enum:
        - normaal
        - vertrouwelijk
        - opgeheven
    VerwerktObjectBasis:
      title: Verwerkt object basis
      description: Een persoon of object betrokken bij de verwerkingsactie.
      type: object
      required: 
        - objecttype
        - soortObjectId
        - objectId
      properties:
        objecttype: 
          title: Objecttype
          description: Soort object dat bij de verwerkingsactie betrokken is.
          type: string
          enum:
            - persoon
        soortObjectId:
          title: Soort object ID
          description: Soort identificator waarmee het object geïdentificeerd wordt.
          type: string
          maxLength: 242
          example: BSN
        objectId:
          title: Object ID
          description: Identificator van het object.
          type: string
          format: identificator
          maxLength: 40
          example: "1234567"
        betrokkenheid:
          title: Betrokkenheid
          description: Geeft aan in welke hoedanigheid de persoon of het object betrokken was bij de verwerkingsactie.
          type: string
          maxLength: 242
          example: Getuige
        verwerkteSoortenGegevens:
          title: Verwerkte soorten gegevens
          type: array
          items: 
            $ref: '#/components/schemas/VerwerktSoortGegeven'
    VerwerktObject:
      title: Verwerkt object
      allOf:
        - type: object
          required: 
            - url
            - verwerktObjectId
          properties:
            url:
              title: URL
              description: URL-referentie naar deze resource. Deze link wordt automatisch aangemaakt.
              type: string
              format: uri
              maxLength: 2042
              minLength: 1
              # readOnly: true
              example: "https://verwerkingenlogging-bewerking-api.vng.cloud/api/v1/verwerkte-objecten/5f089abb-7ed1-4714-92d4-1850453eda5d"
            verwerktObjectId:
              title: Verwerkt object ID
              description: Identificator van het verwerkte object. Deze ID wordt automatisch aangemaakt door het log.
              type: string
              format: uuid
              # readOnly: true
              example: "5f089abb-7ed1-4714-92d4-1850453eda5d"
        - $ref: '#/components/schemas/VerwerktObjectBasis'
    VerwerktSoortGegeven:
      title: Verwerkt soort gegeven
      description: Een soort gegeven dat over een persoon of object betrokken bij een verwerkingsactie verwerkt is.
      type: object
      required: 
        - soortGegeven
      properties:
        soortGegeven:
          title: Soort gegeven
          description: Soort gegeven dat verwerkt is.
          type: string
          maxLength: 242
          example: "BSN"
    PatchRequestBody:
      title: Wijzig bewaartermijn van Verwerking
      type: object
      properties:
        bewaartermijn:
          title: Bewaartermijn
          description: Periode waarin de verwerking bewaard moet blijven.
          type: string
          format: duration
          example: P10Y
        vertrouwelijkheid:
          title: Vertrouwelijkheid
          description: Geeft de mate van vertrouwelijkheid van de verwerking aan.
          type: string
          enum:
            - normaal
            - vertrouwelijk
            - opgeheven
servers:
  # Added by API Auto Mocking Plugin
  - description: SwaggerHub API Auto Mocking
    url: https://virtserver.swaggerhub.com/KorverInformatica/logging-verwerkingen-beheer-api/0.9.0
  - url: https://localhost:8000/api/v1
  - url: https://verwerkingenlogging-bewerking-api.vng.cloud/api/v1