openapi: 3.2.0
info:
  title: Pagopa Eservice Templates API
  contact:
    name: API Support
    url: https://github.com/pagopa/pdnd-interop-frontend/issues
  termsOfService: https://selfcare.interop.pagopa.it/ui/it/termini-di-servizio
  x-summary: PDND Interoperability API
  version: '1.0'
  description: 'Operations tagged eserviceTemplates across 3 of this provider''s published API definitions: interop-api-v3.yaml, pagopa-pdnd-interop-v2-openapi.yml, pagopa-pdnd-interop-v3-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.interop.pagopa.it/v3
  description: Production environment
- url: https://api.interop.pagopa.it/v2
  description: PROD environment
tags:
- name: eserviceTemplates
  description: E-Service Templates routes
paths:
  /eserviceTemplates:
    get:
      tags:
      - eserviceTemplates
      summary: List E-Service Templates
      description: Retrieve a list of E-Service Templates based on filters
      operationId: getEServiceTemplates
      parameters:
      - in: query
        name: name
        description: Filter E-Service Templates by name
        schema:
          type: string
      - in: query
        name: eserviceTemplateIds
        description: Filter E-Service Templates by IDs. If not specified, return E-Service Templates with any ID
        schema:
          type: array
          items:
            $ref: '#/components/schemas/EServiceTemplateId'
          default: []
        explode: false
      - in: query
        name: creatorIds
        description: Filter E-Service Templates by creator IDs. If not specified, return E-Service Templates for any creator
        schema:
          type: array
          items:
            type: string
            format: uuid
          default: []
        explode: false
      - $ref: '#/components/parameters/OffsetParam'
      - $ref: '#/components/parameters/LimitParam'
      responses:
        '200':
          description: E-Service Templates retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplates'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    post:
      tags:
      - eserviceTemplates
      summary: Create a new E-Service Template
      operationId: createEServiceTemplate
      requestBody:
        description: An E-Service Template seed
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EServiceTemplateSeed'
        required: true
      responses:
        '201':
          description: E-Service Template created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplate'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template id
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    get:
      tags:
      - eserviceTemplates
      summary: Retrieve an E-Service Template
      operationId: getEServiceTemplate
      responses:
        '200':
          description: E-Service Template retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplate'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    patch:
      tags:
      - eserviceTemplates
      summary: Update a Draft E-Service Template
      description: 'Update an E-Service Template in Draft state.

        The E-Service Template must have a single version, and that version must be in Draft state.'
      operationId: updateDraftEServiceTemplate
      requestBody:
        content:
          application/merge-patch+json:
            schema:
              $ref: '#/components/schemas/EServiceTemplateDraftUpdateSeed'
        required: true
      responses:
        '200':
          description: Draft E-Service Template updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplate'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    delete:
      tags:
      - eserviceTemplates
      summary: Delete an E-Service Template in Draft state
      operationId: deleteEServiceTemplate
      responses:
        '200':
          description: E-Service Template deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoidObject'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/description:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    patch:
      tags:
      - eserviceTemplates
      summary: Update the description of an E-Service Template after its publication
      description: Update the description of an E-Service Template in Published or Suspended state
      operationId: updatePublishedEServiceTemplateDescription
      requestBody:
        required: true
        content:
          application/merge-patch+json:
            schema:
              $ref: '#/components/schemas/EServiceTemplateDescriptionUpdateSeed'
      responses:
        '200':
          description: E-Service Template description updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplate'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/intendedTarget:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    patch:
      tags:
      - eserviceTemplates
      summary: Update the intended target of an E-Service Template after its publication
      description: Update the intended target of an E-Service Template in Published or Suspended state
      operationId: updatePublishedEServiceTemplateIntendedTarget
      requestBody:
        required: true
        content:
          application/merge-patch+json:
            schema:
              $ref: '#/components/schemas/EServiceTemplateIntendedTargetUpdateSeed'
      responses:
        '200':
          description: E-Service Template intended target updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplate'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/name:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    patch:
      tags:
      - eserviceTemplates
      summary: Update the name of an E-Service Template after its publication
      description: Update the name of an E-Service Template in Published or Suspended state
      operationId: updatePublishedEServiceTemplateName
      requestBody:
        required: true
        content:
          application/merge-patch+json:
            schema:
              $ref: '#/components/schemas/EServiceTemplateNameUpdateSeed'
      responses:
        '200':
          description: E-Service Template name updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplate'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID of the Versions to retrieve
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    get:
      tags:
      - eserviceTemplates
      summary: List E-Service Template Versions
      description: Retrieve a list of E-Service Template Versions based on filters
      operationId: getEServiceTemplateVersions
      parameters:
      - name: state
        in: query
        description: Filter Versions by states. If not specified, return Versions in any state
        schema:
          $ref: '#/components/schemas/EServiceTemplateVersionState'
      - $ref: '#/components/parameters/OffsetParam'
      - $ref: '#/components/parameters/LimitParam'
      responses:
        '200':
          description: E-Service Template Versions retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateVersions'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    post:
      tags:
      - eserviceTemplates
      summary: Create a new E-Service Template Version
      description: 'Create a new E-Service Template Version.

        This E-Service Template must not already have a Version in a Draft state.'
      operationId: createEServiceTemplateVersion
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EServiceTemplateVersionSeed'
        required: true
      responses:
        '201':
          description: E-Service Template Version created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateVersion'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID of the Version
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version to retrieve
      required: true
      schema:
        type: string
        format: uuid
    get:
      tags:
      - eserviceTemplates
      summary: Retrieve an E-Service Template Version
      operationId: getEServiceTemplateVersion
      responses:
        '200':
          description: E-Service Template Version retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateVersion'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    patch:
      tags:
      - eserviceTemplates
      summary: Update a Draft E-Service Template Version
      description: Update an E-Service Template Version in Draft state
      operationId: updateDraftEServiceTemplateVersion
      requestBody:
        required: true
        content:
          application/merge-patch+json:
            schema:
              $ref: '#/components/schemas/EServiceTemplateVersionDraftUpdateSeed'
      responses:
        '200':
          description: Draft E-Service Template Version updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateVersion'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    delete:
      tags:
      - eserviceTemplates
      summary: Delete an E-Service Template Version
      description: 'Delete an E-Service Template Version in Draft state

        It is not possible to delete the last remaining Version for a Template.'
      operationId: deleteDraftEServiceTemplateVersion
      responses:
        '200':
          description: E-Service Template Version deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoidObject'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/suspend:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID of the Version
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version to suspend
      required: true
      schema:
        type: string
        format: uuid
    post:
      tags:
      - eserviceTemplates
      summary: Suspend an E-Service Template Version in Published state
      description: Suspend an E-Service Template Version that is in Published state, transitioning it to Suspended state
      operationId: suspendEServiceTemplateVersion
      responses:
        '200':
          description: E-Service Template Version suspended
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateVersion'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/unsuspend:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID of the Version
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version to unsuspend
      required: true
      schema:
        type: string
        format: uuid
    post:
      tags:
      - eserviceTemplates
      summary: Unsuspend an E-Service Template Version in Suspended state
      description: Unsuspend an E-Service Template Version that is in Suspended state, transitioning it to Published state
      operationId: unsuspendEServiceTemplateVersion
      responses:
        '200':
          description: E-Service Template Version unsuspended
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateVersion'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/publish:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID of the Version
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version to publish
      required: true
      schema:
        type: string
        format: uuid
    post:
      tags:
      - eserviceTemplates
      summary: Publish an E-Service Template Version in Draft state
      description: Publish an E-Service Template Version that is in Draft state, transitioning it to Published state
      operationId: publishEServiceTemplateVersion
      responses:
        '200':
          description: E-Service Template Version published
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateVersion'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/documents:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID of the Version
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version
      required: true
      schema:
        type: string
        format: uuid
    get:
      tags:
      - eserviceTemplates
      summary: List E-Service Template Version Documents
      description: Retrieve a list of Documents for the specified E-Service Template Version
      operationId: getEServiceTemplateVersionDocuments
      parameters:
      - $ref: '#/components/parameters/OffsetParam'
      - $ref: '#/components/parameters/LimitParam'
      responses:
        '200':
          description: E-Service Template Version Documents retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Documents'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    post:
      tags:
      - eserviceTemplates
      summary: Upload an E-Service Template Version Document
      description: Upload a Document for the specified E-Service Template Version
      operationId: uploadEServiceTemplateVersionDocument
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/FileUploadMultipart'
        required: true
      responses:
        '201':
          description: Version Document uploaded successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Document'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/documents/{documentId}:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version
      required: true
      schema:
        type: string
        format: uuid
    - name: documentId
      in: path
      description: The ID of the Document to retrieve or delete
      required: true
      schema:
        type: string
        format: uuid
    get:
      tags:
      - eserviceTemplates
      summary: Download an E-Service Template Version Document
      description: Download a specific Document for the specified E-Service Template Version
      operationId: downloadEServiceTemplateVersionDocument
      responses:
        '200':
          description: E-Service Template Version Document retrieved, a multipart containing the file and its metadata
          content:
            multipart/form-data:
              schema:
                $ref: '#/components/schemas/FileDownloadMultipart'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    delete:
      tags:
      - eserviceTemplates
      summary: Delete an E-Service Template Version Document
      description: Delete a specific Document for the specified E-Service Template Version
      operationId: deleteEServiceTemplateVersionDocument
      responses:
        '200':
          description: E-Service Template Version Document deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoidObject'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/riskAnalyses:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID for which to create a risk analysis
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    post:
      tags:
      - eserviceTemplates
      summary: Create a new Risk Analysis
      description: 'Create a Risk Analysis for an E-Service Template.

        The E-Service Template must be in Draft state and in Receive mode.'
      operationId: createEServiceTemplateRiskAnalysis
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EServiceTemplateRiskAnalysisSeed'
      responses:
        '201':
          description: Risk Analysis created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateRiskAnalysis'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    get:
      tags:
      - eserviceTemplates
      summary: List E-Service Template Risk Analyses
      description: Retrieve a list of Risk Analyses for a specific E-Service Template
      operationId: getEServiceTemplateRiskAnalyses
      parameters:
      - $ref: '#/components/parameters/OffsetParam'
      - $ref: '#/components/parameters/LimitParam'
      responses:
        '200':
          description: E-Service Template Risk Analyses retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateRiskAnalyses'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/riskAnalyses/{riskAnalysisId}:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template id
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: riskAnalysisId
      in: path
      description: The Risk Analysis id
      required: true
      schema:
        type: string
        format: uuid
    get:
      tags:
      - eserviceTemplates
      summary: Retrieve an E-Service Template Risk Analysis
      description: Retrieve a Risk Analysis for an E-Service Template
      operationId: getEServiceTemplateRiskAnalysis
      responses:
        '200':
          description: E-Service Risk Analysis retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateRiskAnalysis'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    delete:
      tags:
      - eserviceTemplates
      summary: Delete an E-Service Template Risk Analysis
      description: 'Delete a Risk Analysis for an E-Service Template.

        The E-Service Template must be in Draft state and in Receive mode.'
      operationId: deleteEServiceTemplateRiskAnalysis
      responses:
        '200':
          description: E-Service Template Risk Analysis deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoidObject'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/quotas:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID of the Version
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version
      required: true
      schema:
        type: string
        format: uuid
    patch:
      tags:
      - eserviceTemplates
      summary: Update the quotas of an E-Service Template Version after its publication
      description: Update the quotas of an E-Service Template Version in Published or Suspended state
      operationId: updatePublishedEServiceTemplateVersionQuotas
      requestBody:
        required: true
        content:
          application/merge-patch+json:
            schema:
              $ref: '#/components/schemas/EServiceTemplateVersionQuotasUpdateSeed'
      responses:
        '200':
          description: E-Service Template Version quotas updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateVersion'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/certifiedAttributes:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID of the Version
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version
      required: true
      schema:
        type: string
        format: uuid
    get:
      tags:
      - eserviceTemplates
      summary: List E-Service Template Version Certified Attributes
      description: Retrieve a list of E-Service Template Version Certified Attributes
      operationId: getEServiceTemplateVersionCertifiedAttributes
      parameters:
      - $ref: '#/components/parameters/OffsetParam'
      - $ref: '#/components/parameters/LimitParam'
      responses:
        '200':
          description: E-Service Template Version Certified Attributes retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateVersionCertifiedAttributes'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/declaredAttributes:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID of the Version
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version
      required: true
      schema:
        type: string
        format: uuid
    get:
      tags:
      - eserviceTemplates
      summary: List E-Service Template Version Declared Attributes
      description: Retrieve a list of E-Service Template Version Declared Attributes
      operationId: getEServiceTemplateVersionDeclaredAttributes
      parameters:
      - $ref: '#/components/parameters/OffsetParam'
      - $ref: '#/components/parameters/LimitParam'
      responses:
        '200':
          description: E-Service Template Version Declared Attributes retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateVersionDeclaredAttributes'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/verifiedAttributes:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID of the Version
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version
      required: true
      schema:
        type: string
        format: uuid
    get:
      tags:
      - eserviceTemplates
      summary: List E-Service Template Version Verified Attributes
      description: Retrieve a list of E-Service Template Version Verified Attributes
      operationId: getEServiceTemplateVersionVerifiedAttributes
      parameters:
      - $ref: '#/components/parameters/OffsetParam'
      - $ref: '#/components/parameters/LimitParam'
      responses:
        '200':
          description: E-Service Template Version Verified Attributes retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateVersionVerifiedAttributes'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/certifiedAttributes/groups/{groupIndex}/attributes:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version
      required: true
      schema:
        type: string
        format: uuid
    - name: groupIndex
      in: path
      description: The index of the group of attributes
      required: true
      schema:
        type: integer
        format: int32
        minimum: 0
    post:
      tags:
      - eserviceTemplates
      summary: Assign E-Service Template Version Certified Attribute to a specific Attribute…
      description: Assign a set of Certified Attributes to the indicated Attribute Group (identified by groupIndex) of an E-Service Template Version
      operationId: assignEServiceTemplateVersionCertifiedAttributesToGroup
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EServiceTemplateVersionAttributesGroupSeed'
      responses:
        '200':
          description: E-Service Descriptor Certified Attribute assigned to the Attribute Group
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoidObject'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/declaredAttributes/groups/{groupIndex}/attributes:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version
      required: true
      schema:
        type: string
        format: uuid
    - name: groupIndex
      in: path
      description: The index of the group of attributes
      required: true
      schema:
        type: integer
        format: int32
        minimum: 0
    post:
      tags:
      - eserviceTemplates
      summary: Assign E-Service Template Version Declared Attributes to a specific Attribute…
      description: Assign a set of Declared Attributes to the indicated Attribute Group (identified by groupIndex) of an E-Service Template Version
      operationId: assignEServiceTemplateVersionDeclaredAttributesToGroup
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EServiceTemplateVersionAttributesGroupSeed'
      responses:
        '200':
          description: E-Service Template Version Declared Attribute assigned to the Attribute Group
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoidObject'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/verifiedAttributes/groups/{groupIndex}/attributes:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version
      required: true
      schema:
        type: string
        format: uuid
    - name: groupIndex
      in: path
      description: The index of the group of attributes
      required: true
      schema:
        type: integer
        format: int32
        minimum: 0
    post:
      tags:
      - eserviceTemplates
      summary: Assign E-Service Template Version Verified Attributes to a specific Attribute…
      description: Assign a set of Verified Attributes to the indicated Attribute Group (identified by groupIndex) of an E-Service Template Version
      operationId: assignEServiceTemplateVersionVerifiedAttributesToGroup
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EServiceTemplateVersionAttributesGroupSeed'
      responses:
        '200':
          description: E-Service Template Version Verified Attribute assigned to the Attribute Group
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoidObject'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/certifiedAttributes/groups/{groupIndex}/attributes/{attributeId}:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version
      required: true
      schema:
        type: string
        format: uuid
    - name: groupIndex
      in: path
      description: The index of the group to which the Attribute belongs
      required: true
      schema:
        type: integer
        format: int32
        minimum: 0
    - name: attributeId
      in: path
      description: The ID of the Certified Attribute
      required: true
      schema:
        $ref: '#/components/schemas/AttributeId'
    delete:
      tags:
      - eserviceTemplates
      summary: Delete an E-Service Template Certified Attribute from a specific Attribute Group
      description: 'Delete a specific Certified Attribute from the indicated Attribute Group (identified by groupIndex) of an E-Service Template Version.

        If the deleted attribute is the last one in the group, the entire group will be removed.'
      operationId: deleteEServiceTemplateVersionCertifiedAttributeFromGroup
      responses:
        '200':
          description: E-Service Template Version Certified Attribute deleted from Attribute Group
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoidObject'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/verifiedAttributes/groups/{groupIndex}/attributes/{attributeId}:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version
      required: true
      schema:
        type: string
        format: uuid
    - name: groupIndex
      in: path
      description: The index of the group to which the Attribute belongs
      required: true
      schema:
        type: integer
        format: int32
        minimum: 0
    - name: attributeId
      in: path
      description: The ID of the Certified Attribute
      required: true
      schema:
        $ref: '#/components/schemas/AttributeId'
    delete:
      tags:
      - eserviceTemplates
      summary: Delete an E-Service Template Verified Attribute from a specific Attribute Group
      description: 'Delete a specific Verified Attribute from the indicated Attribute Group (identified by groupIndex) of an E-Service Template Version.

        If the deleted attribute is the last one in the group, the entire group will be removed.'
      operationId: deleteEServiceTemplateVersionVerifiedAttributeFromGroup
      responses:
        '200':
          description: E-Service Template Version Verified Attribute deleted from Attribute Group
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoidObject'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/declaredAttributes/groups/{groupIndex}/attributes/{attributeId}:
    parameters:
    - name: templateId
      in: path
      description: The ID of the E-Service Template
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the E-Service Template Version
      required: true
      schema:
        type: string
        format: uuid
    - name: groupIndex
      in: path
      description: The index of the group to which the Attribute belongs
      required: true
      schema:
        type: integer
        format: int32
        minimum: 0
    - name: attributeId
      in: path
      description: The ID of the Declared Attribute
      required: true
      schema:
        $ref: '#/components/schemas/AttributeId'
    delete:
      tags:
      - eserviceTemplates
      summary: Delete an E-Service Template Declared Attribute from a specific Attribute Group
      description: 'Delete a specific Declared Attribute from the indicated Attribute Group (identified by groupIndex) of an E-Service Template Version.

        If the deleted attribute is the last one in the group, the entire group will be removed.'
      operationId: deleteEServiceTemplateVersionDeclaredAttributeFromGroup
      responses:
        '200':
          description: E-Service Template Version Declared Attribute deleted from Attribute Group
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoidObject'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/certifiedAttributes/groups:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID of the Version
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version
      required: true
      schema:
        type: string
        format: uuid
    post:
      tags:
      - eserviceTemplates
      summary: Create Certified Attributes Group for E-Service Template Version
      description: Create a new group of Certified Attributes for an E-Service Template Version in Draft state
      operationId: createEServiceTemplateVersionCertifiedAttributesGroup
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EServiceTemplateVersionAttributesGroupSeed'
      responses:
        '201':
          description: Certified Attributes Group created for E-Service Template Version
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateVersionCertifiedAttributesGroup'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/declaredAttributes/groups:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID of the Version
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version
      required: true
      schema:
        type: string
        format: uuid
    post:
      tags:
      - eserviceTemplates
      summary: Create Declared Attributes Group for E-Service Template Version
      description: Create a new group of Declared Attributes for an E-Service Template Version in Draft state
      operationId: createEServiceTemplateVersionDeclaredAttributesGroup
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EServiceTemplateVersionAttributesGroupSeed'
      responses:
        '201':
          description: Declared Attributes Group created for E-Service Template Version
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateVersionDeclaredAttributesGroup'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
  /eserviceTemplates/{templateId}/versions/{versionId}/verifiedAttributes/groups:
    parameters:
    - name: templateId
      in: path
      description: The E-Service Template ID of the Version
      required: true
      schema:
        $ref: '#/components/schemas/TemplateId'
    - name: versionId
      in: path
      description: The ID of the Version
      required: true
      schema:
        type: string
        format: uuid
    post:
      tags:
      - eserviceTemplates
      summary: Create Verified Attributes Group for E-Service Template Version
      description: Create a new group of Verified Attributes for an E-Service Template Version in Draft state
      operationId: createEServiceTemplateVersionVerifiedAttributesGroup
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EServiceTemplateVersionAttributesGroupSeed'
      responses:
        '201':
          description: Verified Attributes Group created for E-Service Template Version
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EServiceTemplateVersionVerifiedAttributesGroup'
          headers:
            X-Rate-Limit-Limit:
              $ref: '#/components/headers/RateLimitLimitHeader'
            X-Rate-Limit-Remaining:
              $ref: '#/components/headers/RateLimitRemainingHeader'
            X-Rate-Limit-Interval:
              $ref: '#/components/headers/RateLimitIntervalHeader'
            Digest:
              $ref: '#/components/headers/IntegrityRest02DigestHeader'
            Agid-JWT-Signature:
              $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - DPoPAuth: []
        DPoPProofHeader: []
    servers:
    - url: https://api.interop.pagopa.it/v3
      description: Production environment
components:
  schemas:
    EServiceTemplateVersionCertifiedAttributes:
      type: object
      additionalProperties: false
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/EServiceTemplateVersionCertifiedAttribute'
        pagination:
          $ref: '#/components/schemas/Pagination'
      required:
      - results
      - pagination
    RiskAnalysisFormSeed:
      type: object
      additionalProperties: false
      properties:
        version:
          type: string
          minLength: 1
          maxLength: 250
        answers:
          description: 'Key-value pairs of risk analysis form answers.

            Key: question ID; value: array of answers.

            '
          additionalProperties:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 2000
      required:
      - version
      - answers
    EServiceTemplateVersionSeed:
      type: object
      additionalProperties: false
      properties:
        description:
          type: string
          minLength: 10
          maxLength: 250
        voucherLifespan:
          type: integer
          format: int32
          minimum: 60
          maximum: 86400
        dailyCallsPerConsumer:
          description: Maximum number of daily calls that this descriptor can afford per consumer
          type: integer
          format: int32
          minimum: 1
          maximum: 1000000000
        dailyCallsTotal:
          description: Total daily calls available for this E-Service
          type: integer
          format: int32
          minimum: 1
          maximum: 1000000000
        agreementApprovalPolicy:
          $ref: '#/components/schemas/AgreementApprovalPolicy'
      required:
      - voucherLifespan
    EServiceTemplateVersionDraftUpdateSeed:
      type: object
      additionalProperties: false
      properties:
        description:
          type: string
          minLength: 10
          maxLength: 250
        voucherLifespan:
          type: integer
          format: int32
          minimum: 60
          maximum: 86400
        dailyCallsPerConsumer:
          description: Maximum number of daily calls that this descriptor can afford
          type:
          - integer
          - 'null'
          format: int32
          minimum: 1
          maximum: 1000000000
        dailyCallsTotal:
          description: Total daily calls available for this e-service
          type:
          - integer
          - 'null'
          format: int32
          minimum: 1
          maximum: 1000000000
        agreementApprovalPolicy:
          $ref: '#/components/schemas/AgreementApprovalPolicyNullable'
    DeclaredAttribute:
      type: object
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
        description:
          type: string
        name:
          type: string
        createdAt:
          type: string
          format: date-time
      required:
      - id
      - name
      - description
      - createdAt
    Documents:
      type: object
      additionalProperties: false
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/Document'
        pagination:
          $ref: '#/components/schemas/Pagination'
      required:
      - results
      - pagination
    Problem:
      properties:
        type:
          description: URI reference of type definition
          type: string
        status:
          description: The HTTP status code generated by the origin server for this occurrence of the problem
          example: 503
          format: int32
          minimum: 100
          type: integer
          exclusiveMaximum: 600
        title:
          description: A short, summary of the problem type. Written in english and readable
          example: Service Unavailable
          maxLength: 64
          pattern: ^[ -~]{0,64}$
          type: string
        correlationId:
          description: Unique identifier of the request
          example: 53af4f2d-0c87-41ef-a645-b726a821852b
          maxLength: 64
          type: string
        detail:
          description: A human readable explanation of the problem
          example: Request took too long to complete
          maxLength: 4096
          pattern: ^.{0,1024}$
          type: string
        errors:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/ProblemError'
      additionalProperties: false
      required:
      - type
      - status
      - title
    ProblemError:
      properties:
        code:
          description: Internal code of the error
          example: 123-4567
          minLength: 8
          maxLength: 8
          pattern: ^[0-9]{3}-[0-9]{4}$
          type: string
        detail:
          description: A human readable explanation specific to this occurrence of the problem
          example: Parameter not valid
          maxLength: 4096
          pattern: ^.{0,1024}$
          type: string
      required:
      - code
      - detail
    EServiceTemplateVersionCertifiedAttribute:
      type: object
      description: Represents an E-Service Template Version Certified attribute with the index of its attribute group.
      properties:
        groupIndex:
          type: integer
          format: int32
          minimum: 0
          description: The index of the group to which the attribute belongs.
        attribute:
          $ref: '#/components/schemas/CertifiedAttribute'
      required:
      - groupIndex
      - attribute
    EServiceTemplateVersionAttributesGroupSeed:
      type: object
      additionalProperties: false
      properties:
        attributeIds:
          type: array
          items:
            type: string
            format: uuid
      required:
      - attributeIds
    VerifiedAttribute:
      type: object
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
        description:
          type: string
        name:
          type: string
        createdAt:
          type: string
          format: date-time
      required:
      - id
      - name
      - description
      - createdAt
    EServiceTemplateVersionVerifiedAttributes:
      type: object
      additionalProperties: false
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/EServiceTemplateVersionVerifiedAttribute'
        pagination:
          $ref: '#/components/schemas/Pagination'
      required:
      - results
      - pagination
    EServiceTemplate:
      type: object
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
        creatorId:
          type: string
          format: uuid
          description: The ID of the tenant that created the E-Service Template
        name:
          type: string
        intendedTarget:
          type: string
        description:
          type: string
        technology:
          $ref: '#/components/schemas/EServiceTechnology'
        mode:
          $ref: '#/components/schemas/EServiceMode'
        isSignalHubEnabled:
          type: boolean
        personalData:
          type: boolean
      required:
      - id
      - creatorId
      - name
      - intendedTarget
      - description
      - technology
      - mode
    EServiceTemplateNameUpdateSeed:
      type: object
      additionalProperties: false
      properties:
        name:
          type: string
          minLength: 5
          maxLength: 60
      required:
      - name
    EServiceTechnology:
      type: string
      description: API Technology
      enum:
      - REST
      - SOAP
    EServiceTemplateVersion:
      type: object
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
        version:
          type: integer
          format: int32
        description:
          type: string
        voucherLifespan:
          type: integer
          format: int32
        dailyCallsPerConsumer:
          description: Maximum number of daily calls that this descriptor can afford per consumer
          type: integer
          format: int32
          minimum: 1
          maximum: 1000000000
        dailyCallsTotal:
          description: Total daily calls available for this E-Service
          type: integer
          format: int32
          minimum: 1
          maximum: 1000000000
        state:
          $ref: '#/components/schemas/EServiceTemplateVersionState'
        agreementApprovalPolicy:
          $ref: '#/components/schemas/AgreementApprovalPolicy'
        publishedAt:
          type: string
          format: date-time
        suspendedAt:
          type: string
          format: date-time
        deprecatedAt:
          type: string
          format: date-time
      required:
      - id
      - version
      - state
      - creationDate
      - voucherLifespan
    EServiceTemplateVersionCertifiedAttributesGroup:
      type: object
      additionalProperties: false
      properties:
        attributes:
          type: array
          items:
            $ref: '#/components/schemas/EServiceTemplateVersionCertifiedAttribute'
      required:
      - attributes
    EServiceTemplateVersionDeclaredAttribute:
      type: object
      description: Represents an E-Service Template Version Declared attribute with the index of its attribute group.
      properties:
        groupIndex:
          type: integer
          format: int32
          minimum: 0
          description: The index of the group to which the attribute belongs.
        attribute:
          $ref: '#/components/schemas/DeclaredAttribute'
      required:
      - groupIndex
      - attribute
    Document:
      type: object
      additionalProperties: false
      required:
      - id
      - name
      - prettyName
      - contentType
      - createdAt
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier of the file
        name:
          type: string
          description: The name of the file
        prettyName:
          type: string
          description: A human-readable name for the file
        contentType:
          type: string
          description: The content type of the file
        createdAt:
          type: string
          format: date-time
          description: The date and time when the file was uploaded
    RiskAnalysisForm:
      type: object
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
        version:
          type: string
          minLength: 1
          maxLength: 250
        answers:
          description: 'Key-value pairs of risk analysis form answers.

            Key: question ID; value: array of answers

            '
          additionalProperties:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 2000
      required:
      - version
      - answers
    AgreementApprovalPolicyNullable:
      type:
      - string
      - 'null'
      description: E-Service Descriptor policy for new Agreements approval
      enum:
      - AUTOMATIC
      - MANUAL
    AttributeId:
      type: string
      format: uuid
      description: The unique identifier of the Attribute
    EServiceTemplateDraftUpdateSeed:
      type: object
      additionalProperties: false
      properties:
        name:
          type: string
          minLength: 5
          maxLength: 60
        intendedTarget:
          type: string
          minLength: 10
          maxLength: 250
        description:
          type: string
          minLength: 10
          maxLength: 400
        technology:
          $ref: '#/components/schemas/EServiceTechnology'
        mode:
          $ref: '#/components/schemas/EServiceMode'
        isSignalHubEnabled:
          type: boolean
        personalData:
          type:
          - boolean
          - 'null'
    EServiceTemplateId:
      type: string
      format: uuid
      description: The unique identifier of the E-Service Template
    VoidObject:
      type: object
      additionalProperties: false
      description: An empty object
    TemplateId:
      type: string
      format: uuid
      description: The unique identifier of the Template
    EServiceTemplateVersionVerifiedAttribute:
      type: object
      description: Represents an E-Service Template Version Verified attribute with the index of its attribute group.
      properties:
        groupIndex:
          type: integer
          format: int32
          minimum: 0
          description: The index of the group to which the attribute belongs.
        attribute:
          $ref: '#/components/schemas/VerifiedAttribute'
      required:
      - groupIndex
      - attribute
    EServiceMode:
      type: string
      description: Indicates if the E-Service is intended for receiving or delivering data
      enum:
      - RECEIVE
      - DELIVER
    CertifiedAttribute:
      type: object
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
        code:
          type: string
          description: The identifier of the attribute on the source registry
        description:
          type: string
        origin:
          type: string
          description: Identifier of the origin of this attribute, e.g. "IPA"
        name:
          type: string
        createdAt:
          type: string
          format: date-time
      required:
      - id
      - name
      - description
      - code
      - origin
      - createdAt
    EServiceTemplateRiskAnalysisSeed:
      type: object
      additionalProperties: false
      required:
      - name
      - riskAnalysisForm
      - tenantKind
      properties:
        name:
          type: string
        riskAnalysisForm:
          $ref: '#/components/schemas/RiskAnalysisFormSeed'
        tenantKind:
          $ref: '#/components/schemas/TenantKind'
    EServiceTemplateRiskAnalysis:
      type: object
      additionalProperties: false
      required:
      - id
      - name
      - riskAnalysisForm
      - tenantKind
      - createdAt
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        riskAnalysisForm:
          $ref: '#/components/schemas/RiskAnalysisForm'
        tenantKind:
          $ref: '#/components/schemas/TenantKind'
        createdAt:
          type: string
          format: date-time
    EServiceTemplateVersionQuotasUpdateSeed:
      type: object
      additionalProperties: false
      properties:
        voucherLifespan:
          type: integer
          format: int32
          minimum: 60
          maximum: 86400
        dailyCallsPerConsumer:
          description: Maximum number of daily calls that this descriptor can afford per consumer
          type: integer
          format: int32
          minimum: 1
          maximum: 1000000000
        dailyCallsTotal:
          description: Total daily calls available for this E-Service
          type: integer
          format: int32
          minimum: 1
          maximum: 1000000000
    EServiceTemplateVersionDeclaredAttributes:
      type: object
      additionalProperties: false
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/EServiceTemplateVersionDeclaredAttribute'
        pagination:
          $ref: '#/components/schemas/Pagination'
      required:
      - results
      - pagination
    AgreementApprovalPolicy:
      type: string
      description: E-Service Descriptor policy for new Agreements approval
      enum:
      - AUTOMATIC
      - MANUAL
    EServiceTemplateIntendedTargetUpdateSeed:
      type: object
      additionalProperties: false
      properties:
        intendedTarget:
          type: string
          minLength: 10
          maxLength: 250
      required:
      - intendedTarget
    FileUploadMultipart:
      type: object
      additionalProperties: false
      required:
      - file
      - prettyName
      properties:
        file:
          type: string
          format: binary
          description: The file to upload
        prettyName:
          type: string
          description: A human-readable name for the file
    EServiceTemplateVersionState:
      type: string
      description: E-Service Template Version State
      enum:
      - DRAFT
      - PUBLISHED
      - DEPRECATED
      - SUSPENDED
    EServiceTemplates:
      type: object
      additionalProperties: false
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/EServiceTemplate'
        pagination:
          $ref: '#/components/schemas/Pagination'
      required:
      - results
      - pagination
    EServiceTemplateVersionDeclaredAttributesGroup:
      type: object
      additionalProperties: false
      properties:
        attributes:
          type: array
          items:
            $ref: '#/components/schemas/EServiceTemplateVersionDeclaredAttribute'
      required:
      - attributes
    EServiceTemplateVersionVerifiedAttributesGroup:
      type: object
      additionalProperties: false
      properties:
        attributes:
          type: array
          items:
            $ref: '#/components/schemas/EServiceTemplateVersionVerifiedAttribute'
      required:
      - attributes
    FileDownloadMultipart:
      type: object
      additionalProperties: false
      required:
      - file
      - filename
      - contentType
      - id
      properties:
        file:
          type: string
          format: binary
          description: The file to download
        filename:
          type: string
          description: The name of the file
        contentType:
          type: string
          description: The content type of the file
        id:
          type: string
          format: uuid
          description: Unique identifier of the file
        prettyName:
          type: string
          description: A human-readable name for the file
    EServiceTemplateVersions:
      type: object
      additionalProperties: false
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/EServiceTemplateVersion'
        pagination:
          $ref: '#/components/schemas/Pagination'
      required:
      - results
      - pagination
    TenantKind:
      type: string
      enum:
      - PA
      - PRIVATE
      - GSP
      - SCP
    EServiceTemplateDescriptionUpdateSeed:
      type: object
      additionalProperties: false
      properties:
        description:
          type: string
          minLength: 10
          maxLength: 400
      required:
      - description
    EServiceTemplateSeed:
      type: object
      additionalProperties: false
      required:
      - name
      - intendedTarget
      - description
      - technology
      - mode
      - version
      properties:
        name:
          type: string
          minLength: 5
          maxLength: 60
        intendedTarget:
          type: string
          minLength: 10
          maxLength: 250
        description:
          type: string
          minLength: 10
          maxLength: 400
        technology:
          $ref: '#/components/schemas/EServiceTechnology'
        mode:
          $ref: '#/components/schemas/EServiceMode'
        version:
          $ref: '#/components/schemas/VersionSeedForEServiceTemplateCreation'
        isSignalHubEnabled:
          type: boolean
    VersionSeedForEServiceTemplateCreation:
      required:
      - voucherLifespan
      type: object
      additionalProperties: false
      properties:
        description:
          type: string
          minLength: 10
          maxLength: 250
        voucherLifespan:
          type: integer
          format: int32
          minimum: 60
          maximum: 86400
        dailyCallsPerConsumer:
          description: Maximum number of daily calls that this descriptor can afford
          type: integer
          format: int32
          minimum: 1
          maximum: 1000000000
        dailyCallsTotal:
          description: Total daily calls available for this e-service
          type: integer
          format: int32
          minimum: 1
          maximum: 1000000000
        agreementApprovalPolicy:
          $ref: '#/components/schemas/AgreementApprovalPolicy'
    Pagination:
      type: object
      additionalProperties: false
      properties:
        offset:
          type: integer
          format: int32
          minimum: 0
        limit:
          type: integer
          format: int32
          minimum: 1
          maximum: 50
        totalCount:
          type: integer
          format: int32
          minimum: 0
      required:
      - offset
      - limit
      - totalCount
    EServiceTemplateRiskAnalyses:
      type: object
      additionalProperties: false
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/EServiceTemplateRiskAnalysis'
        pagination:
          $ref: '#/components/schemas/Pagination'
      required:
      - results
      - pagination
    EServiceTemplateDraftUpdateSeed_2:
      type: object
      additionalProperties: false
      properties:
        name:
          type: string
          minLength: 5
          maxLength: 60
        intendedTarget:
          type: string
          minLength: 10
          maxLength: 250
        description:
          type: string
          minLength: 10
          maxLength: 250
        technology:
          $ref: '#/components/schemas/EServiceTechnology'
        mode:
          $ref: '#/components/schemas/EServiceMode'
        isSignalHubEnabled:
          type: boolean
        personalData:
          type:
          - boolean
          - 'null'
    EServiceTemplateDescriptionUpdateSeed_2:
      type: object
      additionalProperties: false
      properties:
        description:
          type: string
          minLength: 10
          maxLength: 250
      required:
      - description
    EServiceTemplateSeed_2:
      type: object
      additionalProperties: false
      required:
      - name
      - intendedTarget
      - description
      - technology
      - mode
      - version
      properties:
        name:
          type: string
          minLength: 5
          maxLength: 60
        intendedTarget:
          type: string
          minLength: 10
          maxLength: 250
        description:
          type: string
          minLength: 10
          maxLength: 250
        technology:
          $ref: '#/components/schemas/EServiceTechnology'
        mode:
          $ref: '#/components/schemas/EServiceMode'
        version:
          $ref: '#/components/schemas/VersionSeedForEServiceTemplateCreation'
        isSignalHubEnabled:
          type: boolean
  headers:
    IntegrityRest02AgidJwtSignatureHeader:
      description: 'The `Agid-JWT-Signature` header contains a JSON Web Signature (JWS) signed with the PDND API private key.

        It ensures payload integrity and non-repudiation across all responses (both success and error), in compliance with: 1) Linee Guida sull''interoperabilità tecnica delle Pubbliche Amministrazioni - Pattern di sicurezza,  2) RFC 7515 and 3) RFC 7519.

        '
      schema:
        type: string
    RateLimitRemainingHeader:
      schema:
        type: integer
        format: int32
        minimum: 0
      description: Remaining requests within time interval
    RateLimitIntervalHeader:
      schema:
        type: integer
        format: int32
        minimum: 0
      description: Time interval in milliseconds. Allowed requests will be constantly replenished during the interval. At the end of the interval the max allowed requests will be available
    RateLimitLimitHeader:
      schema:
        type: integer
        format: int32
        minimum: 0
      description: Max allowed requests within time interval
    IntegrityRest02DigestHeader:
      schema:
        type: string
        pattern: ^SHA-256=[a-zA-Z0-9+/]{43}=$
      description: 'Digest of the body using the canonical JSON representation of the response body.

        The digest is calculated using the SHA-256 algorithm on the response body

        exactly as it is sent to the client, encoded in Base64 as per RFC 3230

        '
  parameters:
    LimitParam:
      in: query
      name: limit
      description: Maximum number of results to return
      required: true
      schema:
        type: integer
        format: int32
        minimum: 1
        maximum: 50
    OffsetParam:
      in: query
      name: offset
      description: Pagination starting position
      required: true
      schema:
        type: integer
        format: int32
        minimum: 0
  responses:
    Forbidden:
      description: Forbidden
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/RateLimitLimitHeader'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/RateLimitRemainingHeader'
        X-Rate-Limit-Interval:
          $ref: '#/components/headers/RateLimitIntervalHeader'
        Digest:
          $ref: '#/components/headers/IntegrityRest02DigestHeader'
        Agid-JWT-Signature:
          $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
    Conflict:
      description: Conflict
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/RateLimitLimitHeader'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/RateLimitRemainingHeader'
        X-Rate-Limit-Interval:
          $ref: '#/components/headers/RateLimitIntervalHeader'
        Digest:
          $ref: '#/components/headers/IntegrityRest02DigestHeader'
        Agid-JWT-Signature:
          $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
    Unauthorized:
      description: Unauthorized
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/RateLimitLimitHeader'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/RateLimitRemainingHeader'
        X-Rate-Limit-Interval:
          $ref: '#/components/headers/RateLimitIntervalHeader'
        Digest:
          $ref: '#/components/headers/IntegrityRest02DigestHeader'
        Agid-JWT-Signature:
          $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
    BadRequest:
      description: Bad Request
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/RateLimitLimitHeader'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/RateLimitRemainingHeader'
        X-Rate-Limit-Interval:
          $ref: '#/components/headers/RateLimitIntervalHeader'
        Digest:
          $ref: '#/components/headers/IntegrityRest02DigestHeader'
        Agid-JWT-Signature:
          $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
    NotFound:
      description: Not Found
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/RateLimitLimitHeader'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/RateLimitRemainingHeader'
        X-Rate-Limit-Interval:
          $ref: '#/components/headers/RateLimitIntervalHeader'
        Digest:
          $ref: '#/components/headers/IntegrityRest02DigestHeader'
        Agid-JWT-Signature:
          $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
    TooManyRequests:
      description: Too Many Requests
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
      headers:
        X-Rate-Limit-Limit:
          $ref: '#/components/headers/RateLimitLimitHeader'
        X-Rate-Limit-Remaining:
          $ref: '#/components/headers/RateLimitRemainingHeader'
        X-Rate-Limit-Interval:
          $ref: '#/components/headers/RateLimitIntervalHeader'
        Digest:
          $ref: '#/components/headers/IntegrityRest02DigestHeader'
        Agid-JWT-Signature:
          $ref: '#/components/headers/IntegrityRest02AgidJwtSignatureHeader'
  securitySchemes:
    DPoPAuth:
      type: http
      scheme: DPoP
      description: 'This Authorization header must be used alongside the DPoP Proof JWT.

        Use:

        Authorization: DPoP <access_token>


        The access token generated must also have a cnf field.

        '
    DPoPProofHeader:
      type: apiKey
      in: header
      name: DPoP
      description: 'DPoP proof JWT for sender-constrained access. Must accompany the DPoP Authorization header.

        '
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
x-refined-from:
- interop-api-v3.yaml
- pagopa-pdnd-interop-v2-openapi.yml
- pagopa-pdnd-interop-v3-openapi.yml