# Import builder session

Import a previously exported builder session ZIP archive and create a new builder session from it.
The exported bundle is signed. No changes to the bundle contents are allowed before import.
If the bundle is modified in any way, import fails with `400 Bad Request`.
The request must include:
- `session_file`: a ZIP file created by the export endpoint (max size 15 MB).
- `handlers`: redirect handlers for the new imported session.

For details about handlers, participant fields, and `ui_language`, see the
[Create a new builder session](#operation/createBuilderSession) endpoint.

Endpoint: POST /api/builder/sessions/import
Version: 1.0.0
Security: APIKey

## Security:

  - `APIKey` (unknown)
    http bearer API Key

## Header parameters:

  - `Accept` (string, required)
    Specify the response format.

## Request fields (multipart/form-data):

  - `session_file` (string, required)
    ZIP archive exported from `/api/builder/sessions/{session_id}/export`.

  - `handlers` (object, required)

  - `handlers.cancel_handler` (object, required)

  - `handlers.cancel_handler.method` (string, required)
    Enum: "GET"

  - `handlers.cancel_handler.url` (string, required)

  - `participant` (object)

  - `participant.display_name` (string)

  - `participant.email` (string)

  - `participant.external_id` (string)

  - `ui_language` (string)
    Enum: "en-GB", "fi", "de", "pl", "sv"

## Response 201:

  - `201` (unknown)
    Successful response with details about the imported builder session.

## Response 201 fields (application/json):

  - `data` (object, required)

  - `data.id` (string, required)

  - `data.participant` (object, required)

  - `data.participant.display_name` (string | null, required)

  - `data.participant.email` (string | null, required)

  - `data.participant.external_id` (string | null, required)

  - `data.participant._data_type` (string | null)

  - `data.participant.id` (string, required)

  - `data.participant.token` (string)

  - `data.url` (string, required)

## Response 400:

  - `400` (unknown)
    Session import failed. This can happen if the exported bundle was modified.

## Response 400 fields (application/json):

  - `data` (null, required)
    Always null for error responses.

  - `meta` (object, required)

  - `meta.status` (object, required)

  - `meta.status.code` (integer, required)

  - `meta.status.text` (string, required)

  - `meta.error` (object, required)

  - `meta.error.text` (string, required)

  - `meta.error.details` (object)
    Validation details, when available, as a map of what failed to a message or a list of messages.