---
title: "Create a chunked instance import session"
method: POST
path: "/cloud/import/sessions"
tags: ["migration"]
---

# Create a chunked instance import session

`POST /cloud/import/sessions`

## Request

- Base URL: `https://eu.bisibility.com/api/v1`
- URL: `https://eu.bisibility.com/api/v1/cloud/import/sessions`
- Auth: HTTP bearer

## Headers

- `Bisibility-API-Version` 'v1'
- `X-Bisibility-Source` 'sdk' | 'cli' | 'mcp'

## Request body

- CloudImportSessionCreate
  - `chunk_count` integer, required
  - `totals` object
    - `keywords` integer
    - `rank_checks` integer
  - `source_project_id` string, required
  - `version` 7 | 6, required

## Response `201`

Import session created

- CloudImportSessionCreateResponse
  - `chunk_limits` object, required
    - `max_body_bytes` integer, required
    - `max_history_rows` integer, required
    - `max_keywords` integer, required
  - `session_id` string, required
  - `state` 'receiving', required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `409`: Conflict; Unsupported API version
- `413`: Payload too large
- `419`: Migration token invalid or expired
- `423`: Project read-only
- `429`: Rate limited
- `500`: Import failed

## Changes

- **2026-10-19** `a6e1ec0dec82`: 1 breaking, 7 info
  - removed the media type `application/json` for the response with the status `409`
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `400`
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `401`
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `413`
  - …4 more

[Operation history](https://skmtc.dev/bisibility/apis/bisibility-public-api/changes/cloud/import/sessions/post.md)

---

[API](https://skmtc.dev/bisibility/apis/bisibility-public-api.md) · [All operations](https://skmtc.dev/bisibility/apis/bisibility-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bisibility/apis/bisibility-public-api/revisions/a6e1ec0dec82?raw)