[ New ] Workspace events

English Forum Developers & API Changelog
,
1

Summary

Note: Currently, access to this API is exclusively available through a service account in an Enterprise+ domain.

The Asana API now includes workspace-level event streams, a feature designed to provide continuous updates on object changes within Asana. This enhancement is particularly valuable for applications focused on data loss prevention, e-discovery, and archiving. By offering notifications for added, changed, deleted, or undeleted objects—even when typical access controls would limit visibility—developers can ensure their applications maintain the most current data.

This feature extends the capabilities of Asana’s existing events API, incorporating additional resources and actions as outlined in the webhooks guide. Developers with access via a service account in an Enterprise+ domain can leverage these streams to enhance data reliability and operational efficiency in their applications.

Who is affected

This is an endpoint available exclusively to service accounts in an Enterprise+ domain.

Why we’re making this change

The enhanced API ensures better synchronization and reliability in data-handling capabilities, meeting the evolving demands of enterprise applications.

Timeline

This endpoint is immediately available for use.

Usage

A new endpoint, GET /workspaces/{workspace_gid}/events, returns the full record for all events that have occurred since a sync token was created.

Example response

{
  "data": [
    {
      "action": "changed",
      "created_at": "2012-02-22T02:06:58.147Z",
      "parent": {
        "gid": "12345",
        "resource_type": "task",
        "name": "Bug Task"
      },
      "resource": {
        "gid": "12345",
        "resource_type": "task",
        "name": "Bug Task"
      },
      "type": "task",
      "user": {
        "gid": "12345",
        "resource_type": "user",
        "name": "Greg Sanchez"
      }
    }
  ],
  "sync": "de4774f6915eae04714ca93bb2f5ee81",
  "has_more": true
}

For usage, please review the workspace events guide as well as the API reference.

Migration steps

There are no specific migration steps required, as this is a new endpoint. Users with the requisite access can directly leverage this feature in their applications to receive real-time updates from workspace-level event streams.

Resources

2 Likes
2

@AndrewWong - fantastic news for backup tools, account-wide reporting tools, etc. Thank you!

3

Hi all,

We’re aware that some users may be experiencing an issue where “workspace events are not available for this domain.” Our team is actively investigating this, and we’re working on a fix.

We appreciate your patience as we address the problem and will provide updates as soon as we have more information. Thanks for your understanding!

3 Likes