Asana
  1. Events
Asana
  • Attachments
    • Delete an attachment
      DELETE
    • Get an attachment
      GET
    • Get attachments for a task
      GET
    • Upload an attachment
      POST
  • Batch API
    • Submit parallel requests
      POST
  • Custom Fields
    • Create a custom field
      POST
    • Delete a custom field
      DELETE
    • Get a custom field
      GET
    • Update a custom field
      PUT
    • Create an enum option
      POST
    • Reorder a custom field's enum
      POST
    • Update an enum option
      PUT
    • Get a workspace's custom fields
      GET
  • Events
    • Get events on a resource
      GET
  • Goals
    • Get goals
      GET
    • Create a goal
      POST
    • Delete a goal
      DELETE
    • Get a goal
      GET
    • Update a goal
      PUT
    • Add a collaborator to a goal
      POST
    • Add a subgoal to a parent goal
      POST
    • Add a project/portfolio as supporting work for a goal.
      POST
    • Get parent goals from a goal
      GET
    • Remove a collaborator from a goal
      POST
    • Remove a subgoal from a goal
      POST
    • Remove a project/portfolio as supporting work for a goal.
      POST
    • Create a goal metric
      POST
    • Update a goal metric
      POST
    • Get subgoals from a goal
      GET
    • Get supporting work from a goal
      GET
  • Jobs
    • Get a job by id
  • Organization Exports
    • Create an organization export request
    • Get details on an org export request
  • Teams
    • Get teams in an organization
    • Create a team
    • Get a team
    • Add a user to a team
    • Remove a user from a team
    • Get teams for a user
  • Portfolio Memberships
    • Get multiple portfolio memberships
    • Get a portfolio membership
    • Get memberships from a portfolio
  • Portfolios
    • Get multiple portfolios
    • Create a portfolio
    • Delete a portfolio
    • Get a portfolio
    • Update a portfolio
    • Add a custom field to a portfolio
    • Add a portfolio item
    • Add users to a portfolio
    • Get portfolio items
    • Remove a custom field from a portfolio
    • Remove a portfolio item
    • Remove users from a portfolio
  • Custom Field Settings
    • Get a portfolio's custom fields
    • Get a project's custom fields
  • Project Memberships
    • Get a project membership
    • Get memberships from a project
  • Project Statuses
    • Delete a project status
    • Get a project status
    • Get statuses from a project
    • Create a project status
  • Projects
    • Get multiple projects
    • Create a project
    • Delete a project
    • Get a project
    • Update a project
    • Add a custom field to a project
    • Add followers to a project
    • Add users to a project
    • Duplicate a project
    • Remove a custom field from a project
    • Remove followers from a project
    • Remove users from a project
    • Get task count of a project
    • Get projects a task is in
    • Get a team's projects
    • Create a project in a team
    • Get all projects in a workspace
    • Create a project in a workspace
  • Sections
    • Get sections in a project
    • Create a section in a project
    • Move or Insert sections
    • Delete a section
    • Get a section
    • Update a section
    • Add task to section
  • Tasks
    • Get tasks from a project
    • Get tasks from a section
    • Get tasks from a tag
    • Get multiple tasks
    • Create a task
    • Delete a task
    • Get a task
    • Update a task
    • Set dependencies for a task
    • Set dependents for a task
    • Add followers to a task
    • Add a project to a task
    • Add a tag to a task
    • Get dependencies from a task
    • Get dependents from a task
    • Duplicate a task
    • Unlink dependencies from a task
    • Unlink dependents from a task
    • Remove followers from a task
    • Remove a project from a task
    • Remove a tag from a task
    • Set the parent of a task
    • Get subtasks from a task
    • Create a subtask
    • Get tasks from a user task list
    • Search tasks in a workspace
  • Stories
    • Delete a story
    • Get a story
    • Update a story
    • Get stories from a task
    • Create a story on a task
  • Tags
    • Get multiple tags
    • Create a tag
    • Delete a tag
    • Get a tag
    • Update a tag
    • Get a task's tags
    • Get tags in a workspace
    • Create a tag in a workspace
  • Team Memberships
    • Get team memberships
    • Get a team membership
    • Get memberships from a team
    • Get memberships from a user
  • Users
    • Get users in a team
    • Get multiple users
    • Get a user
    • Get a user's favorites
    • Get users in a workspace or organization
  • Time Periods
    • Get time periods
    • Get a time period
  • User Task Lists
    • Get a user task list
    • Get a user's task list
  • Workspace Memberships
    • Get workspace memberships for a user
    • Get a workspace membership
    • Get the workspace memberships for a workspace
  • Webhooks
    • Get multiple webhooks
    • Establish a webhook
    • Delete a webhook
    • Get a webhook
  • Workspaces
    • Get multiple workspaces
    • Get a workspace
    • Update a workspace
    • Add a user to a workspace or organization
    • Remove a user from a workspace or organization
  • Typeahead
    • Get objects via typeahead
  1. Events

Get events on a resource

GET
/events
Events
Returns the full record for all events that have occurred since the sync
token was created.
A GET request to the endpoint /[path_to_resource]/events can be made in
lieu of including the resource ID in the data for the request.
Note: The resource returned will be the resource that triggered the
event. This may be different from the one that the events were requested
for. For example, a subscription to a project will contain events for
tasks contained within the project.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://app.asana.com/api/1.0/events'
Response Response Example
200 - Example 1
{
    "data": [
        {
            "action": "changed",
            "change": {
                "action": "changed",
                "added_value": {
                    "gid": "12345",
                    "resource_type": "user"
                },
                "field": "assignee",
                "new_value": {
                    "gid": "12345",
                    "resource_type": "user"
                },
                "removed_value": {
                    "gid": "12345",
                    "resource_type": "user"
                }
            },
            "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": "task",
                "name": "Greg Sanchez"
            }
        }
    ],
    "sync": "de4774f6915eae04714ca93bb2f5ee81"
}

Request

None

Responses

🟢200Successfully retrieved events.
application/json
Body
The full record for all events that have occurred since the sync token was created.
data
array[object (EventResponse) {7}] 
optional
action
string 
read-onlyoptional
The type of action taken on the resource that triggered the event. This can be one of changed, added, removed, deleted, or undeleted depending on the nature of the event.
Example:
changed
change
object 
read-onlyoptional
Information about the type of change that has occurred. This field is only present when the value of the property action, describing the action taken on the resource, is changed.
created_at
string <date-time>
read-onlyoptional
The timestamp when the event occurred.
Example:
2012-02-22T02:06:58.147Z
parent
object 
optional
For added/removed events, the parent object that resource was added to or removed from. The parent will be null for other event types.
resource
object 
optional
The resource which has triggered the event by being modified in some way.
type
string 
read-onlyoptional
Deprecated: Refer to the resource_type of the resource. The type of the resource that generated the event.
Example:
task
user
object 
optional
The user who triggered the event.
sync
string 
optional
A sync token to be used with the next call to the events endpoint.
Example:
de4774f6915eae04714ca93bb2f5ee81
🟠400400
🟠401401
🟠403403
🟠404404
🔴500500
Previous
Get a workspace's custom fields
Next
Get goals
Built with