Bulk Import

🚧

PERMISSION REQUIRED

CREATE_TOPIC, EDIT_TOPIC, EDIT_SETTINGS, ADD_TOPIC_ICONS (USE_API for the services/v2 endpoints).

The following table describes in more details the permissions that are needed:

ActionPermissions
CREATE - no iconCREATE_TOPIC, EDIT_SETTINGS
CREATE – with iconCREATE_TOPIC, EDIT_SETTINGS, ADD_TOPIC_ICON
CHILDEDIT_TOPIC, EDIT_SETTINGS
MERGEEDIT_TOPIC, EDIT_SETTINGS
DELETEEDIT_TOPIC, EDIT_SETTINGS
UPDATE - no iconEDIT_TOPIC, EDIT_SETTINGS
UPDATE - no iconEDIT_TOPIC, EDIT_SETTINGS, ADD_TOPIC_ICON

Import is implemented through a POST call to /services/v2/topic/bulkImport.json with a csv file enumerating the import operations and an optional icon zip file as part of the call. The API will return 202 – Accepted when the csv file has been successfully loaded. If there is already an import in progress, then this call with return 403 – Forbidden.

After the initial POST to bulkImport, subsequent calls to GET /services/v2/topic/bulkImport/status.json will return the progress of import.
Once the operation is complete, the results of the import can be retrieved by calling GET /services/v2/topic/bulkImport/results.json.
If no bulkImport operation has been run, this API call will return 404 – Not Found.

Language
Authentication
Basic
base64
:
Click Try It! to start a request and see the response here!