Sample - Asana API
POST/projects/{project_gid}/removeMembers

Remove users from a project

Removes specified users from a project's membership and returns the updated project record. Provide the users in members; removing membership does not by itself describe or guarantee any separate follower change.

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

1 parameter · 1 body field
opt_fieldsarray<string>optional
A comma-separated list of project properties to include in the response, including nested properties such as `current_status.author.name`.

Information about the users to remove from the project's membership.

dataobjectoptional
The request data containing the users to remove.

6 status codes
200Returns the updated project record after removing the specified users from the project.
dataobjectoptional
400Returned when a parameter is missing or malformed, or the request syntax is invalid.
errorsarray<object>optional
401Returned when a valid authentication token is not provided.
errorsarray<object>optional
403Returned when the authenticated user cannot access the project or perform the membership change.
errorsarray<object>optional
404Returned when the requested action or project does not exist.
errorsarray<object>optional
500Returned when a server-side problem prevents the request from completing.
errorsarray<object>optional

Error handling

A 400 is returned when the request is missing or malformed, a 401 when no valid authentication token is provided, and a 403 when access is denied. A 404 is returned when the project or action does not exist, and a 500 indicates a server-side failure. Include the required members field and use valid user identifiers such as me, an email address, or a user GID.