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_export
request and store the ID that is returned - Request the
organization_export
every few minutes, until thestate
field contains ‘finished’ - Download the file located at the URL in the
download_url
field - 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"
}