# \[New\] API endpoints for project memberships

**URL:** <https://forum.asana.com/t/new-api-endpoints-for-project-memberships/753512>\
**Category:** Changelog\
**Tags:** memberships-api, team-memberships-api\
**Created:** [25 March 2024 20:40 UTC](https://forum.asana.com/t/new-api-endpoints-for-project-memberships/753512 "2024-03-25T20:40:35Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Jeff\_Schneider](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/jeff_schneider/32/146_2.png) [@Jeff\_Schneider](https://forum.asana.com/u/Jeff_Schneider)\
**Post date:** [25 March 2024 20:40 UTC](https://forum.asana.com/t/new-api-endpoints-for-project-memberships/753512/1 "2024-03-25T20:40:35Z")

</div>

## Summary

- You can now create, update, and delete project memberships using the `/memberships` API!

- Previously, you could add a member to a project over the API, but the project’s `default_access_level` would determine the member’s role. With this release, you can now specify a member’s role explicitly!

- With full CRUD operations now available for `/memberships` , we are marking the `/project_memberships` membership endpoints as deprecated. We’re still working on a deprecation timeline.

## Usage

**API endpoints to access or modify project memberships:**

- [GET /memberships](https://developers.asana.com/reference/getmemberships)
- [GET /memberships/{membership\_gid}](https://developers.asana.com/reference/getmembership)
- [new!] [POST /memberships](https://developers.asana.com/reference/createmembership)
- [new!] [PUT /memberships/{membership\_gid}](https://developers.asana.com/reference/updatemembership)
- [new!] [DELETE /memberships/{membership\_gid}](https://developers.asana.com/reference/deletemembership)

**Project member roles:**

- `admin`
- `editor`
- `commenter`
- `viewer` (coming soon!)

[See this guide article](https://help.asana.com/hc/en-us/articles/23684192485531-Individual-project-permissions#gl-individual-user-permissions) for details on the levels of access for each role.

**Example request body to create a project membership:**

```JSON
{
  "data": {
  "member": "12345", // user gid
  "parent": "6789", // project gid
  "access_level": "admin"
  }
}

```

## Timeline

Today, these access levels are available for Asana users. Later this year, we will introduce support for team memberships. [More on that here](https://forum.asana.com/t/change-project-team-sharing-is-coming/). We will follow up with more information about `/project_memberships` deprecation soon.

Let us know if you have questions or comments about the memberships endpoints!