module Octokit::Client::Organizations
Methods for the Organizations
API
Public Instance Methods
Add team member
Requires authenticated organization owner or member with team `admin` permission.
@param team_id [Integer] Team id. @param user [String] GitHub username of new team member. @return [Boolean] True on successful addition, false otherwise. @see developer.github.com/v3/orgs/teams/#add-team-member @example
@client.add_team_member(100000, 'pengwynn')
@example
# Opt-in to future behavior for this endpoint. Adds the member to the # team if they're already an org member. If not, the method will return # 422 and indicate the user should call the new Team Membership endpoint. @client.add_team_member \ 100000, 'pengwynn', :accept => "application/vnd.github.the-wasp-preview+json"
@see developer.github.com/changes/2014-08-05-team-memberships-api/
# File lib/octokit/client/organizations.rb, line 428 def add_team_member(team_id, user, options = {}) # There's a bug in this API call. The docs say to leave the body blank, # but it fails if the body is both blank and the content-length header # is not 0. boolean_from_response :put, "teams/#{team_id}/members/#{user}", options.merge({:name => user}) end
Add or invite a user to a team
@param team_id [Integer] Team id. @param user [String] GitHub username of the user to invite.
@return [Sawyer::Resource] Hash of team membership info
@see developer.github.com/v3/orgs/teams/#add-or-update-team-membership
@example Check if a user has a membership for a team
@client.add_team_membership(1234, 'pengwynn')
# File lib/octokit/client/organizations.rb, line 649 def add_team_membership(team_id, user, options = {}) put "teams/#{team_id}/memberships/#{user}", options end
Add team repository
This can also be used to update the permission of an existing team
Requires authenticated user to be an owner of the organization that the team is associated with. Also, the repo must be owned by the organization, or a direct form of a repo owned by the organization.
@param team_id [Integer] Team id. @param repo [String, Hash, Repository] A GitHub repository. @option options [String] :permission The permission to grant the team.
Only valid on organization-owned repositories. Can be one of: <tt>pull</tt>, <tt>push</tt>, or <tt>admin</tt>. If not specified, the team's <tt>permission</tt> attribute will be used to determine what permission to grant the team on this repository.
@return [Boolean] True if successful, false otherwise. @see Octokit::Repository
@see developer.github.com/v3/orgs/teams/#add-or-update-team-repository @example
@client.add_team_repository(100000, 'github/developer.github.com')
@example
@client.add_team_repo(100000, 'github/developer.github.com')
@example Add a team with admin permissions
@client.add_team_repository(100000, 'github/developer.github.com', permission: 'admin')
# File lib/octokit/client/organizations.rb, line 540 def add_team_repository(team_id, repo, options = {}) boolean_from_response :put, "teams/#{team_id}/repos/#{Repository.new(repo)}", options end
List all GitHub organizations
This provides a list of every organization, in the order that they were created.
@param options [Hash] Optional options. @option options [Integer] :since The integer ID of the last Organization
that you’ve seen.
@see developer.github.com/v3/orgs/#list-all-organizations
@return [Array<Sawyer::Resource>] List of GitHub organizations.
# File lib/octokit/client/organizations.rb, line 100 def all_organizations(options = {}) paginate "organizations", options end
List child teams
Requires authenticated organization member.
@param team_id [Integer] Team id. @return [Sawyer::Resource] Hash representing team. @see developer.github.com/v3/orgs/teams/#list-child-teams @example
@client.child_teams(100000, :accept => "application/vnd.github.hellcat-preview+json")
# File lib/octokit/client/organizations.rb, line 350 def child_teams(team_id, options = {}) options = ensure_api_media_type(:nested_teams, options) paginate "teams/#{team_id}/teams", options end
Converts an organization member to an outside collaborator
Requires authenticated organization members.
@param org [String, Integer] Organization
GitHub login or id. @param user [String] GitHub username to be removed as outside collaborator @return [Boolean] Return true if outside collaborator removed from organization, false otherwise. @see developer.github.com/v3/orgs/outside-collaborators/#convert-member-to-outside-collaborator
@example
@client.convert_to_outside_collaborator('github', 'lizzhale')
# File lib/octokit/client/organizations.rb, line 268 def convert_to_outside_collaborator(org, user, options={}) boolean_from_response :put, "#{Organization.path org}/outside_collaborators/#{user}", options end
Create team
Requires authenticated organization owner.
@param org [String, Integer] Organization
GitHub login or id. @option options [String] :name Team name. @option options [Array<String>] :repo_names Repositories
for the team. @option options [Array<String>] :maintainers Maintainers for the team. @option options [Integer] :parent_team_id ID of a team to set as the parent team. @return [Sawyer::Resource] Hash representing new team. @see developer.github.com/v3/orgs/teams/#create-team @example
@client.create_team('github', { :name => 'Designers', :repo_names => ['github/dotfiles'] })
# File lib/octokit/client/organizations.rb, line 304 def create_team(org, options = {}) if options.key?(:permission) octokit_warn "Deprecated: Passing :permission option to #create_team. Assign team repository permission by passing :permission to #add_team_repository instead." end if options.key?(:parent_team_id) options = ensure_api_media_type(:nested_teams, options) end post "#{Organization.path org}/teams", options end
Deletes a previous migration archive.
Requires authenticated organization owner.
@param org [String, Integer] Organization
GitHub login or id. @param id [Integer] ID number of the migration. @see developer.github.com/v3/orgs/migrations/#delete-a-migration-archive
# File lib/octokit/client/organizations.rb, line 787 def delete_migration_archive(org, id, options = {}) options = ensure_api_media_type(:migrations, options) delete "orgs/#{org}/migrations/#{id}/archive", options end
Delete team
Requires authenticated organization owner.
@param team_id [Integer] Team id. @return [Boolean] True if deletion successful, false otherwise. @see developer.github.com/v3/orgs/teams/#delete-team @example
@client.delete_team(100000)
# File lib/octokit/client/organizations.rb, line 390 def delete_team(team_id, options = {}) boolean_from_response :delete, "teams/#{team_id}", options end
Fetches the URL to a migration archive.
Requires authenticated organization owner.
@param org [String, Integer] Organization
GitHub login or id. @param id [Integer] ID number of the migration. @see developer.github.com/v3/orgs/migrations/#download-a-migration-archive
# File lib/octokit/client/organizations.rb, line 772 def migration_archive_url(org, id, options = {}) options = ensure_api_media_type(:migrations, options) url = "orgs/#{org}/migrations/#{id}/archive" response = client_without_redirects(options).get(url) response.headers['location'] end
Fetches the status of a migration.
Requires authenticated organization owner.
@param org [String, Integer] Organization
GitHub login or id. @param id [Integer] ID number of the migration. @see developer.github.com/v3/orgs/migrations/#get-the-status-of-a-migration
# File lib/octokit/client/organizations.rb, line 760 def migration_status(org, id, options = {}) options = ensure_api_media_type(:migrations, options) get "orgs/#{org}/migrations/#{id}", options end
Lists the most recent migrations.
Requires authenticated organization owner.
@param org [String, Integer] Organization
GitHub login or id. @return [Array<Sawyer::Resource>] Array of migration resources. @see developer.github.com/v3/orgs/migrations/#get-a-list-of-migrations
# File lib/octokit/client/organizations.rb, line 748 def migrations(org, options = {}) options = ensure_api_media_type(:migrations, options) paginate "orgs/#{org}/migrations", options end
Get an organization
@param org [String, Integer] Organization
GitHub login or id. @return [Sawyer::Resource] Hash representing GitHub organization. @see developer.github.com/v3/orgs/#get-an-organization @example
Octokit.organization('github')
@example
Octokit.org('github')
# File lib/octokit/client/organizations.rb, line 18 def organization(org, options = {}) get Organization.path(org), options end
List pending organization invitations
Requires authenticated organization member.
@param org [String, Integer] Organization
GitHub login or id. @return [Array<Sawyer::Resource>] Array of hashes representing invitations. @see developer.github.com/v3/orgs/members/#list-pending-organization-invitations
@example
@client.organization_invitations('github')
# File lib/octokit/client/organizations.rb, line 223 def organization_invitations(org, options = {}) get "#{Organization.path org}/invitations", options end
Check if a user is a member of an organization.
Use this to check if another user is a member of an organization that you are a member. If you are not in the organization you are checking, use .organization_public_member? instead.
@param org [String, Integer] Organization
GitHub login or id. @param user [String] GitHub username of the user to check.
@return [Boolean] Is a member?
@see developer.github.com/v3/orgs/members/#check-membership
@example Check if a user is in your organization
@client.organization_member?('your_organization', 'pengwynn') => false
# File lib/octokit/client/organizations.rb, line 183 def organization_member?(org, user, options = {}) result = boolean_from_response(:get, "#{Organization.path org}/members/#{user}", options) if !result && last_response && last_response.status == 302 boolean_from_response :get, last_response.headers['Location'] else result end end
Get organization members
Public members of the organization are returned by default. An authenticated client that is a member of the GitHub organization is required to get private members.
@param org [String, Integer] Organization
GitHub login or id. @return [Array<Sawyer::Resource>] Array of hashes representing users. @see developer.github.com/v3/orgs/members/#members-list @example
Octokit.organization_members('github')
@example
Octokit.org_members('github')
# File lib/octokit/client/organizations.rb, line 144 def organization_members(org, options = {}) options = options.dup path = "public_" if options.delete(:public) paginate "#{Organization.path org}/#{path}members", options end
Get an organization membership
@param org [Integer, String] The GitHub Organization
. @option options [String] :user The login of the user, otherwise authenticated user. @return [Sawyer::Resource] Hash representing the organization membership. @see developer.github.com/v3/orgs/members/#get-your-organization-membership @see developer.github.com/v3/orgs/members/#get-organization-membership
# File lib/octokit/client/organizations.rb, line 681 def organization_membership(org, options = {}) options = options.dup if user = options.delete(:user) get "#{Organization.path(org)}/memberships/#{user}", options else get "user/memberships/orgs/#{org}", options end end
List all organizations memberships for the authenticated user
@return [Array<Sawyer::Resource>] Array of organizations memberships. @see developer.github.com/v3/orgs/members/#list-your-organization-memberships
# File lib/octokit/client/organizations.rb, line 669 def organization_memberships(options = {}) paginate "user/memberships/orgs", options end
Check if a user is a public member of an organization.
If you are checking for membership of a user of an organization that you are in, use .organization_member? instead.
@param org [String, Integer] Organization
GitHub login or id. @param user [String] GitHub username of the user to check.
@return [Boolean] Is a public member?
@see developer.github.com/v3/orgs/members/#check-public-membership
@example Check if a user is a hubbernaut
@client.organization_public_member?('github', 'pengwynn') => true
# File lib/octokit/client/organizations.rb, line 208 def organization_public_member?(org, user, options = {}) boolean_from_response :get, "#{Organization.path org}/public_members/#{user}", options end
Get organization public members
Lists the public members of an organization
@param org [String] Organization
GitHub username. @return [Array<Sawyer::Resource>] Array of hashes representing users. @see developer.github.com/v3/orgs/members/#public-members-list @example
Octokit.organization_public_members('github')
@example
Octokit.org_public_members('github')
# File lib/octokit/client/organizations.rb, line 162 def organization_public_members(org, options = {}) organization_members org, options.merge(:public => true) end
List organization repositories
Public repositories are available without authentication. Private repos require authenticated organization member.
@param org [String, Integer] Organization
GitHub login or id for which
to list repos.
@option options [String] :type ('all') Filter by repository type.
`all`, `public`, `member`, `sources`, `forks`, or `private`.
@return [Array<Sawyer::Resource>] List of repositories @see developer.github.com/v3/repos/#list-organization-repositories @example
Octokit.organization_repositories('github')
@example
Octokit.org_repositories('github')
@example
Octokit.org_repos('github')
@example
@client.org_repos('github', {:type => 'private'})
# File lib/octokit/client/organizations.rb, line 125 def organization_repositories(org, options = {}) paginate "#{Organization.path org}/repos", options end
List teams
Requires authenticated organization member.
@param org [String, Integer] Organization
GitHub login or id. @return [Array<Sawyer::Resource>] Array of hashes representing teams. @see developer.github.com/v3/orgs/teams/#list-teams @example
@client.organization_teams('github')
@example
@client.org_teams('github')
# File lib/octokit/client/organizations.rb, line 283 def organization_teams(org, options = {}) paginate "#{Organization.path org}/teams", options end
Get organizations for a user.
Nonauthenticated calls to this method will return organizations that the user is a public member.
Use an authenicated client to get both public and private organizations for a user.
Calling this method on a `@client` will return that users organizations. Private organizations are included only if the `@client` is authenticated.
@param user [Integer, String] GitHub user login or id of the user to get
list of organizations.
@return [Array<Sawyer::Resource>] Array of hashes representing organizations. @see developer.github.com/v3/orgs/#list-your-organizations @see developer.github.com/v3/orgs/#list-user-organizations @example
Octokit.organizations('pengwynn')
@example
@client.organizations('pengwynn')
@example
Octokit.orgs('pengwynn')
@example
Octokit.list_organizations('pengwynn')
@example
Octokit.list_orgs('pengwynn')
@example
@client.organizations
# File lib/octokit/client/organizations.rb, line 81 def organizations(user=nil, options = {}) paginate "#{User.path user}/orgs", options end
List outside collaborators for an organization
Requires authenticated organization members.
@param org [String, Integer] Organization
GitHub login or id. @return [Array<Sawyer::Resource>] Array of hashes representing users. @see developer.github.com/v3/orgs/outside_collaborators/#list-outside-collaborators
@example
@client.outside_collaborators('github')
# File lib/octokit/client/organizations.rb, line 238 def outside_collaborators(org, options={}) get "#{Organization.path org}/outside_collaborators", options end
Publicize a user's membership of an organization
Requires authenticated organization owner.
@param org [String, Integer] Organization
GitHub login or id. @param user [String] GitHub username of user to publicize. @return [Boolean] True if publicization successful, false otherwise. @see developer.github.com/v3/orgs/members/#publicize-a-users-membership @example
@client.publicize_membership('github', 'pengwynn')
# File lib/octokit/client/organizations.rb, line 594 def publicize_membership(org, user, options = {}) boolean_from_response :put, "#{Organization.path org}/public_members/#{user}", options end
Remove organization member
Requires authenticated organization owner or member with team `admin` access.
@param org [String, Integer] Organization
GitHub login or id. @param user [String] GitHub username of user to remove. @return [Boolean] True if removal is successful, false otherwise. @see developer.github.com/v3/orgs/members/#remove-a-member @example
@client.remove_organization_member('github', 'pengwynn')
@example
@client.remove_org_member('github', 'pengwynn')
# File lib/octokit/client/organizations.rb, line 577 def remove_organization_member(org, user, options = {}) # this is a synonym for: for team in org.teams: remove_team_member(team.id, user) # provided in the GH API v3 boolean_from_response :delete, "#{Organization.path org}/members/#{user}", options end
Remove an organization membership
@param org [String] Organization
GitHub login. @return [Boolean] Success @see developer.github.com/v3/orgs/members/#remove-organization-membership
# File lib/octokit/client/organizations.rb, line 717 def remove_organization_membership(org, options = {}) options = options.dup user = options.delete(:user) user && boolean_from_response(:delete, "orgs/#{org}/memberships/#{user}", options) end
Remove outside collaborator from an organization
Requires authenticated organization members.
@param org [String, Integer] Organization
GitHub login or id. @param user [String] GitHub username to be removed as outside collaborator @return [Boolean] Return true if outside collaborator removed from organization, false otherwise. @see developer.github.com/v3/orgs/outside-collaborators/#remove-outside-collaborator
@example
@client.remove_outside_collaborator('github', 'lizzhale')
# File lib/octokit/client/organizations.rb, line 253 def remove_outside_collaborator(org, user, options={}) boolean_from_response :delete, "#{Organization.path org}/outside_collaborators/#{user}", options end
Remove team member
Requires authenticated organization owner or member with team `admin` permission.
@param team_id [Integer] Team id. @param user [String] GitHub username of the user to boot. @return [Boolean] True if user removed, false otherwise. @see developer.github.com/v3/orgs/teams/#remove-team-member @example
@client.remove_team_member(100000, 'pengwynn')
# File lib/octokit/client/organizations.rb, line 446 def remove_team_member(team_id, user, options = {}) boolean_from_response :delete, "teams/#{team_id}/members/#{user}", options end
Remove team membership
@param team_id [Integer] Team id. @param user [String] GitHub username of the user to boot. @return [Boolean] True if user removed, false otherwise. @see developer.github.com/v3/orgs/teams/#remove-team-membership @example
@client.remove_team_membership(100000, 'pengwynn')
# File lib/octokit/client/organizations.rb, line 661 def remove_team_membership(team_id, user, options = {}) boolean_from_response :delete, "teams/#{team_id}/memberships/#{user}", options end
Remove team repository
Removes repository from team. Does not delete the repository.
Requires authenticated organization owner.
@param team_id [Integer] Team id. @param repo [String, Hash, Repository] A GitHub repository. @return [Boolean] Return true if repo removed from team, false otherwise. @see Octokit::Repository
@see developer.github.com/v3/orgs/teams/#remove-team-repository @example
@client.remove_team_repository(100000, 'github/developer.github.com')
@example
@client.remove_team_repo(100000, 'github/developer.github.com')
# File lib/octokit/client/organizations.rb, line 560 def remove_team_repository(team_id, repo, options = {}) boolean_from_response :delete, "teams/#{team_id}/repos/#{Repository.new(repo)}" end
Initiates the generation of a migration archive.
Requires authenticated organization owner.
@param org [String, Integer] Organization
GitHub login or id. @param repositories [Array<String>] :repositories Repositories
for the organization. @option options [Boolean, optional] :lock_repositories Indicates whether repositories should be locked during migration @return [Sawyer::Resource] Hash representing the new migration. @example
@client.start_migration('github', ['github/dotfiles'])
@see developer.github.com/v3/orgs/migrations/#start-a-migration
# File lib/octokit/client/organizations.rb, line 735 def start_migration(org, repositories, options = {}) options = ensure_api_media_type(:migrations, options) options[:repositories] = repositories post "orgs/#{org}/migrations", options end
Get team
Requires authenticated organization member.
@param team_id [Integer] Team id. @return [Sawyer::Resource] Hash representing team. @see developer.github.com/v3/orgs/teams/#get-team @example
@client.team(100000)
# File lib/octokit/client/organizations.rb, line 323 def team(team_id, options = {}) get "teams/#{team_id}", options end
Get team by name and org
Requires authenticated organization member.
@param org [String, Integer] Organization
GitHub login or id. @param team_slug [String] Team slug. @return [Sawyer::Resource] Hash representing team. @see developer.github.com/v3/teams/#get-team-by-name @example
@client.team_by_name("github", "justice-league")
# File lib/octokit/client/organizations.rb, line 337 def team_by_name(org, team_slug, options = {}) get "#{Organization.path(org)}/teams/#{team_slug}", options end
List pending team invitations
Requires authenticated organization member.
@param team_id [Integer] Team id. @return [Array<Sawyer::Resource>] Array of hashes representing invitations. @see developer.github.com/v3/orgs/teams/#list-pending-team-invitations
@example
@client.team_invitations('github')
# File lib/octokit/client/organizations.rb, line 479 def team_invitations(team_id, options = {}) get "teams/#{team_id}/invitations", options end
Check if a user is a member of a team.
Use this to check if another user is a member of a team that you are a member.
@param team_id [Integer] Team id. @param user [String] GitHub username of the user to check.
@return [Boolean] Is a member?
@see developer.github.com/v3/orgs/teams/#get-team-member
@example Check if a user is in your team
@client.team_member?(100000, 'pengwynn') => false
# File lib/octokit/client/organizations.rb, line 465 def team_member?(team_id, user, options = {}) boolean_from_response :get, "teams/#{team_id}/members/#{user}", options end
List team members
Requires authenticated organization member.
@param team_id [Integer] Team id. @return [Array<Sawyer::Resource>] Array of hashes representing users. @see developer.github.com/v3/orgs/teams/#list-team-members @example
@client.team_members(100000)
# File lib/octokit/client/organizations.rb, line 403 def team_members(team_id, options = {}) paginate "teams/#{team_id}/members", options end
Check if a user has a team membership.
@param team_id [Integer] Team id. @param user [String] GitHub username of the user to check.
@return [Sawyer::Resource] Hash of team membership info
@see developer.github.com/v3/orgs/teams/#get-team-membership
@example Check if a user has a membership for a team
@client.team_membership(1234, 'pengwynn')
# File lib/octokit/client/organizations.rb, line 634 def team_membership(team_id, user, options = {}) get "teams/#{team_id}/memberships/#{user}", options end
List team repositories
Requires authenticated organization member.
@param team_id [Integer] Team id. @return [Array<Sawyer::Resource>] Array of hashes representing repositories. @see developer.github.com/v3/orgs/teams/#list-team-repos @example
@client.team_repositories(100000)
@example
@client.team_repos(100000)
# File lib/octokit/client/organizations.rb, line 494 def team_repositories(team_id, options = {}) paginate "teams/#{team_id}/repos", options end
Check if a repo is managed by a specific team
@param team_id [Integer] Team ID. @param repo [String, Hash, Repository] A GitHub repository. @return [Boolean] True if managed by a team. False if not managed by
the team OR the requesting user does not have authorization to access the team information.
@see developer.github.com/v3/orgs/teams/#check-if-a-team-manages-a-repository @example
@client.team_repository?(8675309, 'octokit/octokit.rb')
@example
@client.team_repo?(8675309, 'octokit/octokit.rb')
# File lib/octokit/client/organizations.rb, line 511 def team_repository?(team_id, repo, options = {}) boolean_from_response :get, "teams/#{team_id}/repos/#{Repository.new(repo)}" end
Unlock a previous migration archive.
Requires authenticated organization owner.
@param org [String, Integer] Organization
GitHub login or id. @param id [Integer] ID number of the migration. @param repo [String] Name of the repository. @see developer.github.com/v3/orgs/migrations/#unlock-a-repository
# File lib/octokit/client/organizations.rb, line 800 def unlock_repository(org, id, repo, options = {}) options = ensure_api_media_type(:migrations, options) delete "orgs/#{org}/migrations/#{id}/repos/#{repo}/lock", options end
Conceal a user's membership of an organization.
Requires authenticated organization owner.
@param org [String, Integer] Organization
GitHub login or id. @param user [String] GitHub username of user to unpublicize. @return [Boolean] True of unpublicization successful, false otherwise. @see developer.github.com/v3/orgs/members/#conceal-a-users-membership @example
@client.unpublicize_membership('github', 'pengwynn')
@example
@client.conceal_membership('github', 'pengwynn')
# File lib/octokit/client/organizations.rb, line 610 def unpublicize_membership(org, user, options = {}) boolean_from_response :delete, "#{Organization.path org}/public_members/#{user}", options end
Update an organization.
Requires authenticated client with proper organization permissions.
@param org [String, Integer] Organization
GitHub login or id. @param values [Hash] The updated organization attributes. @option values [String] :billing_email Billing email address. This address is not publicized. @option values [String] :company Company name. @option values [String] :email Publicly visible email address. @option values [String] :location Location of organization. @option values [String] :name GitHub username for organization. @option values [String] :default_repository_permission The default permission members have on organization repositories. @option values [Boolean] :members_can_create_repositories Set true to allow members to create repositories on the organization. @return [Sawyer::Resource] Hash representing GitHub organization. @see developer.github.com/v3/orgs/#edit-an-organization @example
@client.update_organization('github', { :billing_email => 'support@github.com', :company => 'GitHub', :email => 'support@github.com', :location => 'San Francisco', :name => 'github' })
@example
@client.update_org('github', {:company => 'Unicorns, Inc.'})
# File lib/octokit/client/organizations.rb, line 48 def update_organization(org, values, options = {}) patch Organization.path(org), options.merge(values) end
Edit an organization membership
@param org [String] Organization
GitHub login. @option options [String] :role The role of the user in the organization. @option options [String] :state The state that the membership should be in. @option options [String] :user The login of the user, otherwise authenticated user. @return [Sawyer::Resource] Hash representing the updated organization membership. @see developer.github.com/v3/orgs/members/#edit-your-organization-membership @see developer.github.com/v3/orgs/members/#add-or-update-organization-membership
# File lib/octokit/client/organizations.rb, line 700 def update_organization_membership(org, options = {}) options = options.dup if user = options.delete(:user) options.delete(:state) put "orgs/#{org}/memberships/#{user}", options else options.delete(:role) patch "user/memberships/orgs/#{org}", options end end
Update team
Requires authenticated organization owner.
@param team_id [Integer] Team id. @option options [String] :name Team name. @option options [String] :permission Permissions the team has for team repositories.
`pull` - team members can pull, but not push to or administer these repositories. `push` - team members can pull and push, but not administer these repositories. `admin` - team members can pull, push and administer these repositories.
@option options [Integer] :parent_team_id ID of a team to set as the parent team. @return [Sawyer::Resource] Hash representing updated team. @see developer.github.com/v3/orgs/teams/#edit-team @example
@client.update_team(100000, { :name => 'Front-end Designers', :permission => 'push' })
# File lib/octokit/client/organizations.rb, line 374 def update_team(team_id, options = {}) if options.key?(:parent_team_id) options = ensure_api_media_type(:nested_teams, options) end patch "teams/#{team_id}", options end
List all teams for the authenticated user across all their orgs
@return [Array<Sawyer::Resource>] Array of team resources. @see developer.github.com/v3/orgs/teams/#list-user-teams
# File lib/octokit/client/organizations.rb, line 619 def user_teams(options = {}) paginate "user/teams", options end