@heroku-cli/plugin-orgs
v1.8.2
Published
CLI to manage Heroku Organizations
Downloads
306
Maintainers
Keywords
Readme
Heroku Orgs CLI
Available commands
https://github.com/heroku/heroku-orgs/blob/master/index.js.
Development
First, please read Developing CLI Plugins on Heroku's DevCenter.
Run Tests
$ npm test
Deploy
- Release a new version of this npm package.
$ npm version patch/minor/major
- Open a new pr in https://github.com/heroku/cli/blob/master/package.json, updating to the appropriate heroku-orgs version.
Commands
heroku access
heroku access:add EMAIL
heroku access:remove EMAIL
heroku access:update EMAIL
heroku apps:join
heroku apps:leave
heroku apps:lock
heroku apps:transfer RECIPIENT
heroku apps:unlock
heroku join
heroku leave
heroku lock
heroku members
heroku members:add EMAIL
heroku members:remove EMAIL
heroku members:set EMAIL
heroku orgs
heroku orgs:open
heroku teams
heroku unlock
heroku access
list who has access to an app
USAGE
$ heroku access
OPTIONS
-a, --app=app (required) app to run command against
-r, --remote=remote git remote of app to use
--json output in json format
heroku access:add EMAIL
add new users to your app
USAGE
$ heroku access:add EMAIL
OPTIONS
-a, --app=app (required) app to run command against
-p, --permissions=permissions list of permissions comma separated
-r, --remote=remote git remote of app to use
EXAMPLES
$ heroku access:add [email protected] --app APP # add a collaborator to your app
$ heroku access:add [email protected] --app APP --permissions deploy,manage,operate # permissions must be comma separated
heroku access:remove EMAIL
remove users from a team app
USAGE
$ heroku access:remove EMAIL
OPTIONS
-a, --app=app (required) app to run command against
-r, --remote=remote git remote of app to use
EXAMPLES
$ heroku access:remove [email protected] --app APP
heroku access:update EMAIL
update existing collaborators on an team app
USAGE
$ heroku access:update EMAIL
OPTIONS
-a, --app=app (required) app to run command against
-p, --permissions=permissions comma-delimited list of permissions to update (deploy,manage,operate)
-r, --remote=remote git remote of app to use
EXAMPLES
$ heroku access:update [email protected] --app APP --permissions deploy,manage,operate
heroku apps:join
add yourself to an organization app
USAGE
$ heroku apps:join
OPTIONS
-a, --app=app (required) app to run command against
-r, --remote=remote git remote of app to use
heroku apps:leave
remove yourself from an organization app
USAGE
$ heroku apps:leave
OPTIONS
-a, --app=app (required) app to run command against
-r, --remote=remote git remote of app to use
heroku apps:lock
prevent organization members from joining an app
USAGE
$ heroku apps:lock
OPTIONS
-a, --app=app (required) app to run command against
-r, --remote=remote git remote of app to use
heroku apps:transfer RECIPIENT
transfer applications to another user or team
USAGE
$ heroku apps:transfer RECIPIENT
ARGUMENTS
RECIPIENT user or team to transfer applications to
OPTIONS
-a, --app=app app to run command against
-l, --locked lock the app upon transfer
-r, --remote=remote git remote of app to use
--bulk transfer applications in bulk
DESCRIPTION
Examples:
$ heroku apps:transfer [email protected]
Transferring example to [email protected]... done
$ heroku apps:transfer acme-widgets
Transferring example to acme-widgets... done
$ heroku apps:transfer --bulk acme-widgets
...
heroku apps:unlock
unlock an app so any organization member can join
USAGE
$ heroku apps:unlock
OPTIONS
-a, --app=app (required) app to run command against
-r, --remote=remote git remote of app to use
heroku join
add yourself to an organization app
USAGE
$ heroku join
OPTIONS
-a, --app=app (required) app to run command against
-r, --remote=remote git remote of app to use
heroku leave
remove yourself from an organization app
USAGE
$ heroku leave
OPTIONS
-a, --app=app (required) app to run command against
-r, --remote=remote git remote of app to use
heroku lock
prevent organization members from joining an app
USAGE
$ heroku lock
OPTIONS
-a, --app=app (required) app to run command against
-r, --remote=remote git remote of app to use
heroku members
list members of an organization or a team
USAGE
$ heroku members
OPTIONS
-r, --role=role filter by role
-t, --team=team team to use
--json output in json format
--pending filter by pending team invitations
heroku members:add EMAIL
adds a user to an organization or a team
USAGE
$ heroku members:add EMAIL
OPTIONS
-r, --role=role (required) member role (admin, collaborator, member, owner)
-t, --team=team team to use
heroku members:remove EMAIL
removes a user from an organization or a team
USAGE
$ heroku members:remove EMAIL
OPTIONS
-t, --team=team team to use
heroku members:set EMAIL
sets a members role in an organization or a team
USAGE
$ heroku members:set EMAIL
OPTIONS
-r, --role=role (required) member role (admin, collaborator, member, owner)
-t, --team=team team to use
heroku orgs
list the organizations that you are a member of
USAGE
$ heroku orgs
OPTIONS
--enterprise filter by enterprise orgs
--json output in json format
--teams filter by teams
heroku orgs:open
open the organization interface in a browser window
USAGE
$ heroku orgs:open
OPTIONS
-t, --team=team team to use
heroku teams
list the teams that you are a member of
USAGE
$ heroku teams
OPTIONS
--json output in json format
heroku unlock
unlock an app so any organization member can join
USAGE
$ heroku unlock
OPTIONS
-a, --app=app (required) app to run command against
-r, --remote=remote git remote of app to use