Set organization membership for a user

Only authenticated organization owners can add a member to the organization or update the member's role.

If the authenticated user is adding a member to the organization, the invited user will receive an email inviting them to the organization. The user's membership status will be pending until they accept the invitation.

Authenticated users can update a user's membership by passing the role parameter. If the authenticated user changes a member's role to admin, the affected user will receive an email notifying them that they've been made an organization owner. If the authenticated user changes an owner's role to member, no email will be sent.

Rate limits

To prevent abuse, the authenticated user is limited to 50 organization invitations per 24 hour period. If the organization is more than one month old or on a paid plan, the limit is 500 invitations per 24 hour period.

curl --location --request PUT 'https://api.github.com/orgs//memberships/' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "role": "member" }'

{ "organization": { "avatar_url": "https://github.com/images/error/octocat_happy.gif", "description": "A great organization", "events_url": "https://api.github.com/orgs/github/events", "hooks_url": "https://api.github.com/orgs/github/hooks", "id": 1, "issues_url": "https://api.github.com/orgs/github/issues", "login": "github", "members_url": "https://api.github.com/orgs/github/members{/member}", "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=", "public_members_url": "https://api.github.com/orgs/github/public_members{/member}", "repos_url": "https://api.github.com/orgs/github/repos", "url": "https://api.github.com/orgs/github" }, "organization_url": "https://api.github.com/orgs/octocat", "permissions": { "can_create_repository": true }, "role": "admin", "state": "active", "url": "https://api.github.com/orgs/octocat/memberships/defunkt", "user": { "avatar_url": "https://github.com/images/error/octocat_happy.gif", "events_url": "https://api.github.com/users/octocat/events{/privacy}", "followers_url": "https://api.github.com/users/octocat/followers", "following_url": "https://api.github.com/users/octocat/following{/other_user}", "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", "gravatar_id": "41d064eb2195891e12d0413f63227ea7", "html_url": "https://github.com/octocat", "id": 1, "login": "octocat", "node_id": "MDQ6VXNlcjE=", "organizations_url": "https://api.github.com/users/octocat/orgs", "received_events_url": "https://api.github.com/users/octocat/received_events", "repos_url": "https://api.github.com/users/octocat/repos", "site_admin": true, "starred_at": "\"2020-07-09T00:17:55Z\"", "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", "type": "User", "url": "https://api.github.com/users/octocat" } }

Set organization membership for a user

请求参数

返回响应