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

# Import Bundle

> Imports a previously exported bundle ZIP file. Returns a report with
manifest, imported items and any warnings.

Requires `templates.import`. **No automatic rollback** — back up the
database before importing in production.




## OpenAPI

````yaml /api-reference/openapi/EvoAI-CRM-Service/templates.yaml post /api/v1/templates/import
openapi: 3.0.4
info:
  title: Evolution Foundation - CRM Service - Template Bundles
  description: >
    Export and import configuration bundles (inboxes, agents, automation

    rules, canned responses, templates, custom roles) as portable ZIP files.


    Available starting `v1.0.0-rc3` (EVO-1116).


    See the user guide: [Configuration
    Bundles](/user-guides/settings/template-bundles).


    **Note:** This OpenAPI spec was generated from the controller as part of the
    rc3 release. Schemas reflect the controller surface but request/response
    examples may need refinement based on real payloads.
  version: 1.0.0
servers:
  - url: https://api.evoai.app
  - url: http://localhost:3000
security: []
paths:
  /api/v1/templates/import:
    post:
      summary: Import Bundle
      description: |
        Imports a previously exported bundle ZIP file. Returns a report with
        manifest, imported items and any warnings.

        Requires `templates.import`. **No automatic rollback** — back up the
        database before importing in production.
      operationId: import-template-bundle
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              required:
                - bundle_file
              properties:
                bundle_file:
                  type: string
                  format: binary
                  description: The ZIP bundle file to import
      responses:
        '200':
          description: Bundle imported successfully
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - data
                  - message
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      manifest:
                        type: object
                        description: The manifest header read from the bundle
                        properties:
                          template_name:
                            type: string
                          description:
                            type: string
                          author:
                            type: string
                          schema_version:
                            type: string
                          exported_at:
                            type: string
                            format: date-time
                      items:
                        type: object
                        description: Per-category list of imported items (id + name)
                        additionalProperties:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                              name:
                                type: string
                              action:
                                type: string
                                enum:
                                  - created
                                  - updated
                                  - skipped
                      warnings:
                        type: array
                        items:
                          type: string
                        description: Non-fatal issues encountered during import
                  message:
                    type: string
                    example: Template imported
        '400':
          description: bundle_file missing
        '413':
          description: File too large
        '422':
          description: Invalid bundle (unsupported schema, malformed, validation error)
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                  code:
                    type: string
                    enum:
                      - TEMPLATE_INVALID_BUNDLE
                      - TEMPLATE_UNSUPPORTED_SCHEMA
                      - TEMPLATE_FILE_TOO_LARGE
                      - TEMPLATE_IMPORT_FAILED
      security:
        - userApiKey: []
components:
  securitySchemes:
    userApiKey:
      type: apiKey
      in: header
      name: api_access_token

````

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