Accessing organization exports
These endpoints are only available to Service Accounts of an Enterprise organization.
An organization_export object represents a request to export the complete data of an organization in JSON format.
To export an organization using this API:
- Create an
organization_exportrequest and store the ID that is returned - Request the
organization_exportevery few minutes, until thestatefield contains ‘finished’ - Download the file located at the URL in the
download_urlfield - Exports can take a long time, from several minutes to a few hours for large organizations
OrganizationExportCompact
A Compact object reflects the default fields returned after a successful API request. See input/output options to include more fields in the response.
| Property | Type | Description |
|---|---|---|
gid | string | Globally unique identifier of the resource, as a string. |
resource_type | string | The base type of this resource. |
created_at | string(date-time) | The time at which this resource was created. |
download_url | string(uri)¦null | Download this URL to retreive the full export of the organization in JSON format. It will be compressed in a gzip (.gz) container. Note: May be null if the export is still in progress or failed. If present, this URL may only be valid for 1 hour from the time of retrieval. You should avoid persisting this URL somewhere and rather refresh on demand to ensure you do not keep stale URLs. |
organization | object | A workspace is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace. |
organization.gid | string | Globally unique identifier of the resource, as a string. |
organization.resource_type | string | The base type of this resource. |
organization.name | string | The name of the workspace. |
state | string | The current state of the export. |
{
"gid": "12345",
"resource_type": "organization_export",
"created_at": "2012-02-22T02:06:58.147Z",
"download_url": "https://asana-export.s3.amazonaws.com/export-4632784536274-20170127-43246.json.gz?AWSAccessKeyId=xxxxxxxx",
"organization": {
"gid": "12345",
"resource_type": "workspace",
"name": "My Company Workspace"
},
"state": "started"
}
OrganizationExport
An object represents a request to export the complete data of an organization in JSON format.
| Property | Type | Description |
|---|---|---|
gid | stringh | Globally unique identifier of the resource, as a string. |
resource_type | string | The base type of this resource. |
created_at | string(date-time) | The time at which this resource was created. |
download_url | string(uri)¦null | Download this URL to retreive the full export of the organization in JSON format. It will be compressed in a gzip (.gz) container. Note: May be null if the export is still in progress or failed. If present, this URL may only be valid for 1 hour from the time of retrieval. You should avoid persisting this URL somewhere and rather refresh on demand to ensure you do not keep stale URLs. |
organization | object | A workspace is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace. |
organization.gid | string | Globally unique identifier of the resource, as a string. |
organization.resource_type | string | The base type of this resource. |
organization.name | string | The name of the workspace. |
organization.state | string | The current state of the export. |
{
"gid": "12345",
"resource_type": "organization_export",
"created_at": "2012-02-22T02:06:58.147Z",
"download_url": "https://asana-export.s3.amazonaws.com/export-4632784536274-20170127-43246.json.gz?AWSAccessKeyId=xxxxxxxx",
"organization": {
"gid": "12345",
"resource_type": "workspace",
"name": "My Company Workspace"
},
"state": "started"
}