---
title: "Start a content import job."
method: POST
path: "/v2/content/folders/{folderId}/import"
tags: ["contentManagement"]
---

# Start a content import job.

`POST /v2/content/folders/{folderId}/import`

Schedule an asynchronous import of content inside an existing folder with the given identifier. Import requests can be used to create or update content within a folder. Content items need to have a unique name within their folder. If there is already a content item with the same name in the folder, you can set the `overwrite` parameter to `true` to overwrite existing content items. By default, the `overwrite` parameter is set to `false`, where the import will fail if a content item with the same name already exist. Keep in mind when importing large folders that there is a limit of 1000 content objects that can be imported at once. If you want to import more than 1000 content objects, then be sure to split the import into batches of 1000 objects or less.

## Path parameters

- `folderId` string, required

## Query parameters

- `overwrite` boolean

## Headers

- `isAdminMode` string

## Request body

- ContentSyncDefinition
  - `type` string, required — The content item type. **Note:** - `MewboardSyncDefinition` _is depreciated, and will soon be removed. Please use_ `DashboardV2SyncDefinition` _instead_. - Dashboard links are not supported for dashboards.
  - `name` string, required — The name of the item.

## Response `200`

Import job has been scheduled.

- BeginAsyncJobResponse
  - `id` string, required — Identifier to get the status of an asynchronous job.

## Other responses

- `default` — The operation failed with an error.

---

[API](https://skmtc.net/sumologic/apis/sumo-logic-api.md) · [All operations](https://skmtc.net/sumologic/apis/sumo-logic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sumologic/sumo-logic-api/revisions/18a824df1e78/schema)