---
title: "Create import v2 task"
method: POST
path: "/imports/v2"
tags: ["product:chat"]
---

# Create import v2 task

`POST /imports/v2`

Creates a new import v2 task

## Request body

- CreateImportV2TaskRequest, nullable — Client request
  - `product` 'chat' | 'feeds', required
  - `settings` ImportV2TaskSettings, required
    - `merge_custom` boolean
    - `mode` string
    - `path` string
    - `s3` ImportV2TaskSettingsS3
      - `bucket` string
      - `dir` string
      - `region` string
    - `skip_references_check` boolean
    - `use_import_time_as_op_time` boolean
  - `user` UserRequest — User request object
    - `custom` object — Custom user data
    - `id` string, required — User ID
    - `image` string — User's profile image URL
    - `invisible` boolean
    - `language` string
    - `name` string — Optional name of user
    - `privacy_settings` PrivacySettingsResponse
      - `delivery_receipts` DeliveryReceiptsResponse
        - `enabled` boolean
      - `read_receipts` ReadReceiptsResponse
        - `enabled` boolean
      - `typing_indicators` TypingIndicatorsResponse
        - `enabled` boolean
    - `role` string — User's global role
    - `teams` string[] — List of teams the user belongs to
    - `teams_role` object — Map of team-specific roles for the user
  - `user_id` string

## Response `201`

Response

- CreateImportV2TaskResponse, nullable — Basic response information
  - `app_pk` integer, required
  - `created_at` string, date-time, required
  - `duration` string, required — Duration of the request in milliseconds
  - `id` string, required
  - `product` string, required
  - `settings` ImportV2TaskSettings, required
    - `merge_custom` boolean
    - `mode` string
    - `path` string
    - `s3` ImportV2TaskSettingsS3
      - `bucket` string
      - `dir` string
      - `region` string
    - `skip_references_check` boolean
    - `use_import_time_as_op_time` boolean
  - `state` integer, required
  - `updated_at` string, date-time, required

## Other responses

- `400` — Bad request
- `429` — Too many requests

---

[API](https://skmtc.net/getstream/apis/stream-api.md) · [All operations](https://skmtc.net/getstream/apis/stream-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getstream/stream-api/versions/3dba86aaa0d8/schema)