[ Change ] Improved accuracy of "is_guest" field for workspace memberships API

English Forum Developers & API Changelog
1

Summary

We’ve improved the accuracy of the is_guest field returned by the workspace_memberships API. Previously, this field always returned true for users who were invited to a workspace but had not yet accepted the invitation — even if they would not be considered guests once they joined.

Now, is_guest will only return true if:

  • The user is currently a guest in the domain (e.g., using an email address outside the organization’s domain), or
  • The invited user will become a guest upon accepting the invitation.

This change makes it easier to determine a user’s true guest status and helps reduce false positives when using is_guest to drive permissions, roles, or UI behavior. Applications that rely on is_guest to distinguish between internal members and external collaborators may need to update their logic accordingly.

Who is affected

This change affects any application that uses the is_guest field to determine user roles, permissions, or access levels.

If your app relies on is_guest to:

  • Differentiate between internal members and external guests,
  • Control UI visibility or feature access,
  • Manage user permissions or workflows based on membership type,

…you may need to review and update your logic, especially if it previously assumed that all invited users were guests.

We recommend auditing any logic that:

  • Assumes is_guest: true for pending invitations,
  • Grants or restricts access based on is_guest,
  • Displays different content or UI states depending on guest status.

Timeline

This new behavior is live now.

Usage

Example response for a pending invite non-guest user when calling GET /workspace_memberships/{workspace_membership_gid}:

{
  "data": {
    "gid": "123",
    "resource_type": "workspace_membership",
    "user": {
      "gid": "123",
      "name": "123@asana.com",
      "resource_type": "user"
    },
    "user_task_list": {
      "gid": "321",
      "resource_type": "user_task_list",
      "name": "name",
      "workspace": {
        "gid": "231",
        "name": "asana.com",
        "resource_type": "workspace"
      }
    },
    "is_active": true,
    "is_admin": false,
    "is_guest": false,
    "is_view_only": false,
    "vacation_dates": null,
    "created_at": "2025-05-06T22:38:51Z"
  }
}
3 Likes