Sample - Asana API
PUT/memberships/{membership_gid}

Update a membership

Updates an existing membership associated with a goal, project, portfolio, custom type, or custom field. Supply only the fields you want to change in the data object; omitted fields retain their current values. A 200 response returns the complete updated membership record.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 body field

The membership fields to update; fields omitted from data remain unchanged.

dataobjectoptional
The membership fields to change, including `access_level` when you need to update the member's permissions. Goals support viewer, commenter, editor, and admin access levels; projects support admin, editor, and commenter access levels; portfolios support admin, editor, and viewer access levels.

6 status codes
200Returns the complete updated membership record.
dataobjectoptional
400Returned when the request is missing or contains a malformed parameter or body value.
errorsarray<object>optional
401Returned when a valid authentication token is not provided.
errorsarray<object>optional
403Returned when the authenticated user does not have access to the membership or its properties.
errorsarray<object>optional
404Returned when the request method or path is unknown, or the membership does not exist.
errorsarray<object>optional
500Returned when a server-side problem prevents the membership from being updated.
errorsarray<object>optional

Error handling

A 400 is returned when the request is missing or contains malformed information. A 401 is returned when you do not provide a valid authentication token, and a 403 is returned when the authenticated user lacks access to the membership or its properties. A 404 is returned when the request method, path, or membership is not found; a 500 is returned for a server-side failure.