Project memberships

🚧

Deprecated

These endpoints are now deprecated in favor of the new Memberships endpoints which offer enhanced functionality for projects including setting membership access levels and adding teams as members.


ProjectMembershipCompact

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
parentobjectA project represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.
parent.gidstringGlobally unique identifier of the resource, as a string.
parent.resource_typestringThe base type of this resource.
parent.namestringName of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
memberobjectA member object represents either a team or user.
member.gidstringGlobally unique identifier of the resource, as a string.
member.resource_typestringThe type of the member (team or user)
member.namestringThe name of the member
access_levelstringWhether the member has admin, editor, commenter, or viewer access to the project. Values can be: admin, editor, commenter, viewer.

Example JSON for ProjectMembershipCompact:

{
  "gid": "12345",
  "resource_type": "project_membership",
  "parent": {
    "gid": "12345",
    "resource_type": "project",
    "name": "Stuff to buy"
  },
  "member": {
    "gid": "12345",
    "resource_type": "user",
    "name": "Greg Sanchez"
  },
  "access_level": "admin"
}

ProjectMembershipNormal

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
parentobjectA project represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.
parent.gidstringGlobally unique identifier of the resource, as a string.
parent.resource_typestringThe base type of this resource.
parent.namestringName of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
memberobjectA member object represents either a team or user.
member.gidstringGlobally unique identifier of the resource, as a string.
member.resource_typestringThe type of the member (team or user)
member.namestringThe name of the member
access_levelstringWhether the member has admin, editor, commenter, or viewer access to the project. Values can be: admin, editor, commenter, viewer.
userobjectA user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
user.gidstringGlobally unique identifier of the resource, as a string.
user.resource_typestringThe base type of this resource.
user.namestringRead-only except when same user as requester. The user’s name.
projectobjectA project represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.
project.gidstringGlobally unique identifier of the resource, as a string.
project.resource_typestringThe base type of this resource.
project.namestringName of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
write_accessstringWhether the member has full access or comment-only access to the project. Values can be: full_write, comment_only.

Example JSON for ProjectMembershipNormal:

{
  "gid": "12345",
  "resource_type": "project_membership",
  "parent": {
    "gid": "12345",
    "resource_type": "project",
    "name": "Stuff to buy"
  },
  "member": {
    "gid": "12345",
    "resource_type": "user",
    "name": "Greg Sanchez"
  },
  "access_level": "admin",
  "user": {
    "gid": "12345",
    "resource_type": "user",
    "name": "Greg Sanchez"
  },
  "project": {
    "gid": "12345",
    "resource_type": "project",
    "name": "Stuff to buy"
  },
  "write_access": "full_write"
}
Asana Home
Asana helps you manage projects, focus on what's important, and organize work in one place for seamless collaboration.
© 2023 Asana, Inc.