Module: Octokit::Client::Organizations

Included in:
Octokit::Client
Defined in:
lib/octokit/client/organizations.rb

Overview

Methods for the Organizations API

See Also:

Instance Method Summary collapse

Instance Method Details

#add_team_member(team_id, user, options = {}) ⇒ Boolean

Add team member

Requires authenticated organization owner or member with team ‘admin` permission.

Examples:

@client.add_team_member(100000, 'pengwynn')
# 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"

Parameters:

  • team_id (Integer) —

    Team id.

  • user (String) —

    GitHub username of new team member.

Returns:

  • (Boolean) —

    True on successful addition, false otherwise.

See Also:



333
334
335
336
337
338
 
# File 'lib/octokit/client/organizations.rb', line 333

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_team_membership(team_id, user, options = {}) ⇒ Sawyer::Resource

Add or invite a user to a team

Examples:

Check if a user has a membership for a team

@client.add_team_membership(1234, 'pengwynn')

Parameters:

  • team_id (Integer) —

    Team id.

  • user (String) —

    GitHub username of the user to invite.

Returns:

  • (Sawyer::Resource) —

    Hash of team membership info

See Also:



531
532
533
 
# File 'lib/octokit/client/organizations.rb', line 531

def add_team_membership(team_id, user, options = {})
  put "teams/#{team_id}/memberships/#{user}", options
end

#add_team_repository(team_id, repo, options = {}) ⇒ Boolean Also known as: add_team_repo

Add team repository

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.

Examples:

@client.add_team_repository(100000, 'github/developer.github.com')
@client.add_team_repo(100000, 'github/developer.github.com')

Parameters:

  • team_id (Integer) —

    Team id.

  • repo (String, Hash, Repository) —

    A GitHub repository.

Returns:

  • (Boolean) —

    True if successful, false otherwise.

See Also:



422
423
424
 
# File 'lib/octokit/client/organizations.rb', line 422

def add_team_repository(team_id, repo, options = {})
  boolean_from_response :put, "teams/#{team_id}/repos/#{Repository.new(repo)}", options.merge(:name => Repository.new(repo))
end

#all_organizations(options = {}) ⇒ Array<Sawyer::Resource> Also known as: all_orgs

List all GitHub organizations

This provides a list of every organization, in the order that they were created.

Organization that you’ve seen.

Parameters:

  • options (Hash) (defaults to: {}) —

    Optional options.

Options Hash (options):

  • :since (Integer) —

    The integer ID of the last

Returns:

  • (Array<Sawyer::Resource>) —

    List of GitHub organizations.

See Also:



98
99
100
 
# File 'lib/octokit/client/organizations.rb', line 98

def all_organizations(options = {})
  paginate "organizations"
end

#create_team(org, options = {}) ⇒ Sawyer::Resource

Create team

Requires authenticated organization owner.

Examples:

@client.create_team('github', {
  :name => 'Designers',
  :repo_names => ['github/dotfiles'],
  :permission => 'push'
})

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id.

  • options (Hash) (defaults to: {}) —

    a customizable set of options

Options Hash (options):

  • :name (String) —

    Team name.

  • :repo_names (Array<String>) —

    Repositories for the team.

  • :permission (String, optional) — default: 'pull' —

    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.

Returns:

  • (Sawyer::Resource) —

    Hash representing new team.

See Also:



247
248
249
 
# File 'lib/octokit/client/organizations.rb', line 247

def create_team(org, options = {})
  post "#{Organization.path org}/teams", options
end

#delete_migration_archive(org, id, options = {}) ⇒ Object

Deletes a previous migration archive.

Requires authenticated organization owner.

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id.

  • id (Integer) —

    ID number of the migration.

See Also:



663
664
665
666
 
# File 'lib/octokit/client/organizations.rb', line 663

def delete_migration_archive(org, id, options = {})
  options = ensure_api_media_type(:migrations, options)
  delete "orgs/#{org}/migrations/#{id}/archive", options
end

#delete_team(team_id, options = {}) ⇒ Boolean

Delete team

Requires authenticated organization owner.

Examples:

@client.delete_team(100000)

Parameters:

  • team_id (Integer) —

    Team id.

Returns:

  • (Boolean) —

    True if deletion successful, false otherwise.

See Also:



295
296
297
 
# File 'lib/octokit/client/organizations.rb', line 295

def delete_team(team_id, options = {})
  boolean_from_response :delete, "teams/#{team_id}", options
end

#migration_archive_url(org, id, options = {}) ⇒ Object

Fetches the URL to a migration archive.

Requires authenticated organization owner.

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id.

  • id (Integer) —

    ID number of the migration.

See Also:



648
649
650
651
652
653
654
 
# File 'lib/octokit/client/organizations.rb', line 648

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

#migration_status(org, id, options = {}) ⇒ Object

Fetches the status of a migration.

Requires authenticated organization owner.

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id.

  • id (Integer) —

    ID number of the migration.

See Also:



636
637
638
639
 
# File 'lib/octokit/client/organizations.rb', line 636

def migration_status(org, id, options = {})
  options = ensure_api_media_type(:migrations, options)
  get "orgs/#{org}/migrations/#{id}", options
end

#migrations(org, options = {}) ⇒ Array<Sawyer::Resource>

Lists the most recent migrations.

Requires authenticated organization owner.

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id.

Returns:

  • (Array<Sawyer::Resource>) —

    Array of migration resources.

See Also:



624
625
626
627
 
# File 'lib/octokit/client/organizations.rb', line 624

def migrations(org, options = {})
  options = ensure_api_media_type(:migrations, options)
  paginate "orgs/#{org}/migrations", options
end

#organization(org, options = {}) ⇒ Sawyer::Resource Also known as: org

Get an organization

Examples:

Octokit.organization('github')
Octokit.org('github')

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id.

Returns:

  • (Sawyer::Resource) —

    Hash representing GitHub organization.

See Also:



18
19
20
 
# File 'lib/octokit/client/organizations.rb', line 18

def organization(org, options = {})
  get Organization.path(org), options
end

#organization_member?(org, user, options = {}) ⇒ Boolean Also known as: org_member?

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.

Examples:

Check if a user is in your organization

@client.organization_member?('your_organization', 'pengwynn')
=> false

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id.

  • user (String) —

    GitHub username of the user to check.

Returns:

  • (Boolean) —

    Is a member?

See Also:



180
181
182
183
184
185
186
187
 
# File 'lib/octokit/client/organizations.rb', line 180

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

#organization_members(org, options = {}) ⇒ Array<Sawyer::Resource> Also known as: org_members

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.

Examples:

Octokit.organization_members('github')
Octokit.org_members('github')

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id.

Returns:

  • (Array<Sawyer::Resource>) —

    Array of hashes representing users.

See Also:



142
143
144
145
 
# File 'lib/octokit/client/organizations.rb', line 142

def organization_members(org, options = {})
  path = "public_" if options.delete(:public)
  paginate "#{Organization.path org}/#{path}members", options
end

#organization_membership(org, options = {}) ⇒ Sawyer::Resource Also known as: org_membership

Get an organization membership

Parameters:

  • org (String) —

    Organization GitHub login.

  • options (Hash) (defaults to: {}) —

    a customizable set of options

Options Hash (options):

  • :user (String) —

    The login of the user, otherwise authenticated user.

Returns:

  • (Sawyer::Resource) —

    Hash representing the organization membership.

See Also:



563
564
565
566
567
568
569
 
# File 'lib/octokit/client/organizations.rb', line 563

def organization_membership(org, options = {})
  if user = options.delete(:user)
    get "orgs/#{org}/memberships/#{user}", options
  else
    get "user/memberships/orgs/#{org}", options
  end
end

#organization_memberships(options = {}) ⇒ Array<Sawyer::Resource> Also known as: org_memberships

List all organizations memberships for the authenticated user

Returns:

  • (Array<Sawyer::Resource>) —

    Array of organizations memberships.

See Also:



551
552
553
 
# File 'lib/octokit/client/organizations.rb', line 551

def organization_memberships(options = {})
  paginate "user/memberships/orgs", options
end

#organization_public_member?(org, user, options = {}) ⇒ Boolean Also known as: org_public_member?

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.

Examples:

Check if a user is a hubbernaut

@client.organization_public_member?('github', 'pengwynn')
=> true

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id.

  • user (String) —

    GitHub username of the user to check.

Returns:

  • (Boolean) —

    Is a public member?

See Also:



205
206
207
 
# File 'lib/octokit/client/organizations.rb', line 205

def organization_public_member?(org, user, options = {})
  boolean_from_response :get, "#{Organization.path org}/public_members/#{user}", options
end

#organization_public_members(org, options = {}) ⇒ Array<Sawyer::Resource> Also known as: org_public_members

Get organization public members

Lists the public members of an organization

Examples:

Octokit.organization_public_members('github')
Octokit.org_public_members('github')

Parameters:

  • org (String) —

    Organization GitHub username.

Returns:

  • (Array<Sawyer::Resource>) —

    Array of hashes representing users.

See Also:



159
160
161
 
# File 'lib/octokit/client/organizations.rb', line 159

def organization_public_members(org, options = {})
  organization_members org, options.merge(:public => true)
end

#organization_repositories(org, options = {}) ⇒ Array<Sawyer::Resource> Also known as: org_repositories, org_repos

List organization repositories

Public repositories are available without authentication. Private repos require authenticated organization member.

Examples:

Octokit.organization_repositories('github')
Octokit.org_repositories('github')
Octokit.org_repos('github')
@client.org_repos('github', {:type => 'private'})

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id for which to list repos.

  • options (Hash) (defaults to: {}) —

    a customizable set of options

Options Hash (options):

  • :type (String) — default: 'all' —

    Filter by repository type. ‘all`, `public`, `member`, `sources`, `forks`, or `private`.

Returns:

  • (Array<Sawyer::Resource>) —

    List of repositories

See Also:



123
124
125
 
# File 'lib/octokit/client/organizations.rb', line 123

def organization_repositories(org, options = {})
  paginate "#{Organization.path org}/repos", options
end

#organization_teams(org, options = {}) ⇒ Array<Sawyer::Resource> Also known as: org_teams

List teams

Requires authenticated organization member.

Examples:

@client.organization_teams('github')
@client.org_teams('github')

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id.

Returns:

  • (Array<Sawyer::Resource>) —

    Array of hashes representing teams.

See Also:



221
222
223
 
# File 'lib/octokit/client/organizations.rb', line 221

def organization_teams(org, options = {})
  paginate "#{Organization.path org}/teams", options
end

#organizations(user = nil, options = {}) ⇒ Array<Sawyer::Resource> Also known as: list_organizations, list_orgs, orgs

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.

Examples:

Octokit.organizations('pengwynn')
@client.organizations('pengwynn')
Octokit.orgs('pengwynn')
Octokit.list_organizations('pengwynn')
Octokit.list_orgs('pengwynn')
@client.organizations

Parameters:

  • user (Integer, String) (defaults to: nil) —

    GitHub user login or id of the user to get list of organizations.

Returns:

  • (Array<Sawyer::Resource>) —

    Array of hashes representing organizations.

See Also:



79
80
81
 
# File 'lib/octokit/client/organizations.rb', line 79

def organizations(user=nil, options = {})
  paginate "#{User.path user}/orgs", options
end

#publicize_membership(org, user, options = {}) ⇒ Boolean

Publicize a user’s membership of an organization

Requires authenticated organization owner.

Examples:

@client.publicize_membership('github', 'pengwynn')

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id.

  • user (String) —

    GitHub username of user to publicize.

Returns:

  • (Boolean) —

    True if publicization successful, false otherwise.

See Also:



476
477
478
 
# File 'lib/octokit/client/organizations.rb', line 476

def publicize_membership(org, user, options = {})
  boolean_from_response :put, "#{Organization.path org}/public_members/#{user}", options
end

#remove_organization_member(org, user, options = {}) ⇒ Boolean Also known as: remove_org_member

Remove organization member

Requires authenticated organization owner or member with team ‘admin` access.

Examples:

@client.remove_organization_member('github', 'pengwynn')
@client.remove_org_member('github', 'pengwynn')

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id.

  • user (String) —

    GitHub username of user to remove.

Returns:

  • (Boolean) —

    True if removal is successful, false otherwise.

See Also:



459
460
461
462
463
 
# File 'lib/octokit/client/organizations.rb', line 459

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_organization_membership(org, options = {}) ⇒ Boolean

Remove an organization membership

Parameters:

  • org (String) —

    Organization GitHub login.

Returns:

  • (Boolean) —

    Success

See Also:



595
596
597
598
 
# File 'lib/octokit/client/organizations.rb', line 595

def remove_organization_membership(org, options = {})
  user = options.delete(:user)
  user && boolean_from_response(:delete, "orgs/#{org}/memberships/#{user}", options)
end

#remove_team_member(team_id, user, options = {}) ⇒ Boolean

Remove team member

Requires authenticated organization owner or member with team ‘admin` permission.

Examples:

@client.remove_team_member(100000, 'pengwynn')

Parameters:

  • team_id (Integer) —

    Team id.

  • user (String) —

    GitHub username of the user to boot.

Returns:

  • (Boolean) —

    True if user removed, false otherwise.

See Also:



351
352
353
 
# File 'lib/octokit/client/organizations.rb', line 351

def remove_team_member(team_id, user, options = {})
  boolean_from_response :delete, "teams/#{team_id}/members/#{user}", options
end

#remove_team_membership(team_id, user, options = {}) ⇒ Boolean

Remove team membership

Examples:

@client.remove_team_membership(100000, 'pengwynn')

Parameters:

  • team_id (Integer) —

    Team id.

  • user (String) —

    GitHub username of the user to boot.

Returns:

  • (Boolean) —

    True if user removed, false otherwise.

See Also:



543
544
545
 
# File 'lib/octokit/client/organizations.rb', line 543

def remove_team_membership(team_id, user, options = {})
  boolean_from_response :delete, "teams/#{team_id}/memberships/#{user}", options
end

#remove_team_repository(team_id, repo, options = {}) ⇒ Boolean Also known as: remove_team_repo

Remove team repository

Removes repository from team. Does not delete the repository.

Requires authenticated organization owner.

Examples:

@client.remove_team_repository(100000, 'github/developer.github.com')
@client.remove_team_repo(100000, 'github/developer.github.com')

Parameters:

  • team_id (Integer) —

    Team id.

  • repo (String, Hash, Repository) —

    A GitHub repository.

Returns:

  • (Boolean) —

    Return true if repo removed from team, false otherwise.

See Also:



442
443
444
 
# File 'lib/octokit/client/organizations.rb', line 442

def remove_team_repository(team_id, repo, options = {})
  boolean_from_response :delete, "teams/#{team_id}/repos/#{Repository.new(repo)}"
end

#start_migration(org, repositories, options = {}) ⇒ Sawyer::Resource

Initiates the generation of a migration archive.

Requires authenticated organization owner.

Examples:

@client.start_migration('github', ['github/dotfiles'])

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id.

  • repositories (Array<String>) —

    :repositories Repositories for the organization.

  • options (Hash) (defaults to: {}) —

    a customizable set of options

Options Hash (options):

  • :lock_repositories (Boolean, optional) —

    Indicates whether repositories should be locked during migration

Returns:

  • (Sawyer::Resource) —

    Hash representing the new migration.

See Also:



611
612
613
614
615
 
# File 'lib/octokit/client/organizations.rb', line 611

def start_migration(org, repositories, options = {})
  options = ensure_api_media_type(:migrations, options)
  options[:repositories] = repositories
  post "orgs/#{org}/migrations", options
end

#team(team_id, options = {}) ⇒ Sawyer::Resource

Get team

Requires authenticated organization member.

Examples:

@client.team(100000)

Parameters:

  • team_id (Integer) —

    Team id.

Returns:

  • (Sawyer::Resource) —

    Hash representing team.

See Also:



260
261
262
 
# File 'lib/octokit/client/organizations.rb', line 260

def team(team_id, options = {})
  get "teams/#{team_id}", options
end

#team_member?(team_id, user, options = {}) ⇒ Boolean

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.

Examples:

Check if a user is in your team

@client.team_member?('your_team', 'pengwynn')
=> false

Parameters:

  • team_id (Integer) —

    Team id.

  • user (String) —

    GitHub username of the user to check.

Returns:

  • (Boolean) —

    Is a member?

See Also:



370
371
372
 
# File 'lib/octokit/client/organizations.rb', line 370

def team_member?(team_id, user, options = {})
  boolean_from_response :get, "teams/#{team_id}/members/#{user}", options
end

#team_members(team_id, options = {}) ⇒ Array<Sawyer::Resource>

List team members

Requires authenticated organization member.

Examples:

@client.team_members(100000)

Parameters:

  • team_id (Integer) —

    Team id.

Returns:

  • (Array<Sawyer::Resource>) —

    Array of hashes representing users.

See Also:



308
309
310
 
# File 'lib/octokit/client/organizations.rb', line 308

def team_members(team_id, options = {})
  paginate "teams/#{team_id}/members", options
end

#team_membership(team_id, user, options = {}) ⇒ Sawyer::Resource

Check if a user has a team membership.

Examples:

Check if a user has a membership for a team

@client.team_membership(1234, 'pengwynn')

Parameters:

  • team_id (Integer) —

    Team id.

  • user (String) —

    GitHub username of the user to check.

Returns:

  • (Sawyer::Resource) —

    Hash of team membership info

See Also:



516
517
518
 
# File 'lib/octokit/client/organizations.rb', line 516

def team_membership(team_id, user, options = {})
  get "teams/#{team_id}/memberships/#{user}", options
end

#team_repositories(team_id, options = {}) ⇒ Array<Sawyer::Resource> Also known as: team_repos

List team repositories

Requires authenticated organization member.

Examples:

@client.team_repositories(100000)
@client.team_repos(100000)

Parameters:

  • team_id (Integer) —

    Team id.

Returns:

  • (Array<Sawyer::Resource>) —

    Array of hashes representing repositories.

See Also:



385
386
387
 
# File 'lib/octokit/client/organizations.rb', line 385

def team_repositories(team_id, options = {})
  paginate "teams/#{team_id}/repos", options
end

#team_repository?(team_id, repo, options = {}) ⇒ Boolean Also known as: team_repo?

Check if a repo is managed by a specific team

Examples:

@client.team_repository?(8675309, 'octokit/octokit.rb')
@client.team_repo?(8675309, 'octokit/octokit.rb')

Parameters:

  • team_id (Integer) —

    Team ID.

  • repo (String, Hash, Repository) —

    A GitHub repository.

Returns:

  • (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 Also:



402
403
404
 
# File 'lib/octokit/client/organizations.rb', line 402

def team_repository?(team_id, repo, options = {})
  boolean_from_response :get, "teams/#{team_id}/repos/#{Repository.new(repo)}"
end

#unlock_repository(org, id, repo, options = {}) ⇒ Object

Unlock a previous migration archive.

Requires authenticated organization owner.

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id.

  • id (Integer) —

    ID number of the migration.

  • repo (String) —

    Name of the repository.

See Also:



676
677
678
679
 
# File 'lib/octokit/client/organizations.rb', line 676

def unlock_repository(org, id, repo, options = {})
  options = ensure_api_media_type(:migrations, options)
  delete "orgs/#{org}/migrations/#{id}/repos/#{repo}/lock", options
end

#unpublicize_membership(org, user, options = {}) ⇒ Boolean Also known as: conceal_membership

Conceal a user’s membership of an organization.

Requires authenticated organization owner.

Examples:

@client.unpublicize_membership('github', 'pengwynn')
@client.conceal_membership('github', 'pengwynn')

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id.

  • user (String) —

    GitHub username of user to unpublicize.

Returns:

  • (Boolean) —

    True of unpublicization successful, false otherwise.

See Also:



492
493
494
 
# File 'lib/octokit/client/organizations.rb', line 492

def unpublicize_membership(org, user, options = {})
  boolean_from_response :delete, "#{Organization.path org}/public_members/#{user}", options
end

#update_organization(org, values, options = {}) ⇒ Sawyer::Resource Also known as: update_org

Update an organization.

Requires authenticated client with proper organization permissions.

Examples:

@client.update_organization('github', {
  :billing_email => '[email protected]',
  :company => 'GitHub',
  :email => '[email protected]',
  :location => 'San Francisco',
  :name => 'github'
})
@client.update_org('github', {:company => 'Unicorns, Inc.'})

Parameters:

  • org (String, Integer) —

    Organization GitHub login or id.

  • values (Hash) —

    The updated organization attributes.

Options Hash (values):

  • :billing_email (String) —

    Billing email address. This address is not publicized.

  • :company (String) —

    Company name.

  • :email (String) —

    Publicly visible email address.

  • :location (String) —

    Location of organization.

  • :name (String) —

    GitHub username for organization.

Returns:

  • (Sawyer::Resource) —

    Hash representing GitHub organization.

See Also:



46
47
48
 
# File 'lib/octokit/client/organizations.rb', line 46

def update_organization(org, values, options = {})
  patch Organization.path(org), options.merge(values)
end

#update_organization_membership(org, options = {}) ⇒ Sawyer::Resource Also known as: update_org_membership

Edit an organization membership

Parameters:

  • org (String) —

    Organization GitHub login.

  • options (Hash) (defaults to: {}) —

    a customizable set of options

Options Hash (options):

  • :role (String) —

    The role of the user in the organization.

  • :state (String) —

    The state that the membership should be in.

  • :user (String) —

    The login of the user, otherwise authenticated user.

Returns:

  • (Sawyer::Resource) —

    Hash representing the updated organization membership.

See Also:



581
582
583
584
585
586
587
 
# File 'lib/octokit/client/organizations.rb', line 581

def update_organization_membership(org, options = {})
  if user = options.delete(:user)
    put "orgs/#{org}/memberships/#{user}", options
  else
    patch "user/memberships/orgs/#{org}", options
  end
end

#update_team(team_id, options = {}) ⇒ Sawyer::Resource

Update team

Requires authenticated organization owner.

Examples:

@client.update_team(100000, {
  :name => 'Front-end Designers',
  :permission => 'push'
})

Parameters:

  • team_id (Integer) —

    Team id.

  • options (Hash) (defaults to: {}) —

    a customizable set of options

Options Hash (options):

  • :name (String) —

    Team name.

  • :permission (String) —

    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.

Returns:

  • (Sawyer::Resource) —

    Hash representing updated team.

See Also:



282
283
284
 
# File 'lib/octokit/client/organizations.rb', line 282

def update_team(team_id, options = {})
  patch "teams/#{team_id}", options
end

#user_teams(options = {}) ⇒ Array<Sawyer::Resource>

List all teams for the authenticated user across all their orgs

Returns:

  • (Array<Sawyer::Resource>) —

    Array of team resources.

See Also:



501
502
503
 
# File 'lib/octokit/client/organizations.rb', line 501

def user_teams(options = {})
  paginate "user/teams", options
end