Project Memberships

With the introduction of “comment-only” projects in Asana, a user’s membership in a project comes with associated permissions. These permissions (whether a user has full access to the project or comment-only access) are accessible through the project memberships endpoints described here.

Project Memberships have the following fields:
Field Description
id 1234 Read-only. Globally unique ID of the project membership.
user { id: 12345, name: 'Tim Bizarro' } Read-only. The user in the membership.
project { id: 1234, name: 'Bugs' } Read-only. The project the user is a member of.
write_access 'full_write' 'comment_only' Read-only. Whether the user has full access to the project or has comment-only access.

GET ALL MEMBERSHIPS FOR A PROJECT

GET    /projects/project-id/project_memberships

Returns the compact project membership records for the project.

Parameter Description
project 13579 Required: The project for which to fetch memberships.
user 14641 me sashimi@asana.com If present, the user to filter the memberships to.
# Request
curl -H "Authorization: Bearer <personal_access_token>" \
https://app.asana.com/api/1.0/projects/1331/project_memberships

# Response
HTTP/1.1 200
{
  "data": [
    {
      "id": 1012,
      "user": {
        "id": 1234,
        "name": "Tim Bizarro"
      }
    },
    {
      "id": 1019,
      "user": {
        "id": 5678,
        "name": "Greg Sanchez"
      }
    },
    "~..."
  ]
}

GET A PROJECT MEMBERSHIP

GET    /project_memberships/project-id

Returns the project membership record.

Parameter Description
project 34729 Required: Globally unique identifier for the project membership.
# Request
curl -H "Authorization: Bearer <personal_access_token>" \
https://app.asana.com/api/1.0/project_memberships/1012

# Response
HTTP/1.1 200
{
  "data": {
    "id": 1012,
    "user": {
      "id": 1234,
      "name": "Tim Bizarro"
    },
    "write_access": "full_write"
  }
}