Asana

Get a project membership

GET

/project_memberships/{project_membership_gid}

Project Memberships

Returns the complete project record for a single project membership.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://app.asana.com/api/1.0/project_memberships/'

Response Example

200 - Example 1

{
    "data": {
        "gid": "12345",
        "resource_type": "task",
        "user": {
            "gid": "12345",
            "resource_type": "task",
            "name": "Greg Sanchez"
        },
        "project": {
            "gid": "12345",
            "resource_type": "task",
            "name": "Stuff to buy"
        },
        "write_access": "full_write"
    }
}

Request

Path Params

project_membership_gid

string

required

Responses

🟢200Successfully retrieved the requested project membership.

application/json

Body

data

object (ProjectMembershipResponse)

optional

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

object

ProjectCompact

optional

A 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.

write_access

enum<string>

read-onlyoptional

Whether the user has full access to the project or has comment-only access.

Allowed values:

full_writecomment_only

Example:

full_write

gid

string

read-onlyoptional

Globally unique identifier of the resource, as a string.

Example:

12345

resource_type

string

read-onlyoptional

The base type of this resource.

Example:

task

user

object

UserCompact

optional

A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500

Modified at 2022-09-13 02:00:31

Get a project's custom fields

Get memberships from a project