Exports
The export object and the allowed CRUD operations on the related resource endpoint
Exports let you asynchronously export almost all the Core API resources from your organization's environment. At the moment, two types of format
are available when exporting resources: JSON (default) and CSV.
Exports can be managed via API or using the related back-office app in the Apps section of the admin dashboard.
For each resource, you can specify the relationships you want to add to the export (among the supported ones) as includes
(this way, the included resource will be included in the export with all its attributes). Alternatively, you can specify which fields of the main (and related) resource you want to export by using the fields
array — this will reduce the export size and result in a more clean and efficiently exported dataset. You can also apply some filters
to fine-tune the exported data, and decide to skip redundant attributes excluding them from your export by setting the dry_data
attribute to true
(default is false
).
Except for some particular cases, exported outputs can be used as inputs
for the imports API.
As soon as an export is created you can check the number of items that are going to be exported by inspecting the records_count
attribute. You can poll the status
attribute to check the export progress until it's completed. Then, you can download the exported data using the link exposed in the attachment_url
attribute.
Last updated