Exports¶
An export lets you take what OS holds about your organisation, about one member or about yourself: an archive to keep, move elsewhere or check. It is your right of access and portability (Articles 15 and 20 of the GDPR). An export is separate from erasure: you ask for one before you have an organisation, a member or yourself erased, and neither waits for the other.
Three kinds of export¶
| Kind | What it holds | Who asks for it |
|---|---|---|
organisation |
everything of your organisation in OS: its members, invitations, groups, roles and rules, its service, its notifications, webhooks and events, and its audit trail | whoever holds write on export; the administrator (org-admin) by default |
member |
what OS holds about one member: the membership, their roles, groups and values, their notifications and what they did in the audit trail | the same, when they may also see that member |
| your own | what OS holds about you, in every organisation you are or were a member of | you yourself, without a rule; or Artific on your written request |
An export of your organisation never holds the organisations below yours: each asks for its own. Nobody else sees your own export, your administrator included: it is only in your own list.
Parts¶
An export has parts, each downloaded on its own.
- OS (
os): the archive OS builds of what only OS holds. - The AI features (
core): the conversations, files, knowledge, agents, memory, tasks and usage of the AI features. Only Artific takes this part of a whole organisation or of one member, on your organisation's written request, because it holds every member's work, including what your administrator may otherwise not read. Your own export holds this part for every organisation where your membership is active, narrowed to your own work. - Your account (
account, in your own export only): your name, address, preferences and memberships. Your password and your second sign-in step are not in it.
What is left out¶
- Secrets: keys, an invitation's token, a webhook's secret.
- In an export of your organisation or of a member: what the requester may not see themselves. The manifest counts per file how many rows were left out that way.
- In your own export: other people's ids, such as who invited you or gave you a role.
What the archive holds exactly is in The archive.
How long¶
OS builds an export in the background; that usually takes minutes. When it is ready the requester gets a notification, and for your own export an e-mail. You download it until three days later; then it expires and OS deletes it. A download that breaks off resumes from where it stopped.
An organisation asks for at most five exports a day, and so does a person. Ask for one while the same one is still running and you get that one back.
Ask for your own erasure and your exports, and those of your organisations that hold you, expire, and you ask for no new one.
How to ask for an export and download it is in Exports through the API.