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:
| Action | Permissions |
|---|---|
| CREATE - no icon | CREATE_TOPIC, EDIT_SETTINGS |
| CREATE – with icon | CREATE_TOPIC, EDIT_SETTINGS, ADD_TOPIC_ICON |
| CHILD | EDIT_TOPIC, EDIT_SETTINGS |
| MERGE | EDIT_TOPIC, EDIT_SETTINGS |
| DELETE | EDIT_TOPIC, EDIT_SETTINGS |
| UPDATE - no icon | EDIT_TOPIC, EDIT_SETTINGS |
| UPDATE - no icon | EDIT_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.