US flag signifying that this is a United States Federal Government website An official website of the United States government

Managing teammates

Managing teammates

Invite a teammate

If you’re part of a team using cloud.gov, you can invite teammates to get cloud.gov accounts. You can invite anyone you need to work with, including federal employees and federal contractors.

First, send them an invite. (This may prompt you to log into your cloud.gov account first.)

Then, confirm with them that they have received and accepted the invite. Now they have a cloud.gov account!

If you invited them with an agency email address and they’re part of an agency that has automatic sandbox spaces, they’ll also automatically get a sandbox space in their agency’s cloud.gov org.

Give roles to a teammate

After a teammate gets a cloud.gov account, an Org Manager or Space Manager will need to give them roles in your orgs and spaces so they can collaborate with you. For details about how org and space roles and permissions work, see Cloud Foundry’s documentation.

Org Managers can assign roles using the dashboard or command line. Space Managers can assign roles using the command line.

Organization users

If you’re an Org Manager, go to your dashboard and click on the name of your org.

User roles

On the org page, scroll down to “Organization users”. This lists the org users and their org roles. Change the roles by clicking the checkboxes beside their names. (If you’re the only person in the org, you’ll just see “You are the only user in this organization”.)

Space users

If you’re a Space Manager, go to your dashboard and click on the name of your org, then click on the name of your space.

Space roles

On the space page, scroll down to “Space users”. This lists the space users and their space roles. Change the roles by clicking the checkboxes beside their names. (If you’re the only person in the space, you’ll just see “You are the only user in this space”.)

To give an existing organization user access to a space, go to your space page, click a space name, and scroll down to “Space users”. You can add a person, and then you can give them roles with the checkboxes.

If you’re an Org Manager or Space Manager, here’s how to give your teammates roles for your orgs and spaces. You can check whether you’re an Org Manager using cf org-users <org> and whether you’re a Space Manager using cf space-users <org> <space>.

Check what version of the CLI you’re running: cf -v. If that’s older than the latest version listed here, you should upgrade it to avoid unexpected errors.

Decide which roles to give them. For a complete list of roles, see the Cloud Foundry guide to Org and Space Roles. Examples:

  • If you want to make them an admin for your organization, run:

    cf set-org-role <email> <org> OrgManager
    
  • If you want to give them admin access for a space, run:

    cf set-space-role <email> <org> <space> SpaceManager
    
  • If you want to give them permission to deploy applications in a space, run:

    cf set-space-role <email> <org> <space> SpaceDeveloper
    
  • To give them read-only permissions to the organization, run:

    cf set-org-role <email> <org> OrgAuditor
    

Removing a teammate

If you are an Org Manager or Space Manager, you can remove teammates from orgs and spaces respectively.

Organization Users

If you’re an Org Manager, go to the org with the teammate you want to remove.

On the Organization page, scroll down to the “Organization users” section. This has a list of all the organization users. Click the “Remove User From Org” button.

To remove a teammate from an organization, you must first remove them from any of the organization’s spaces first.

App Overview dashboard

Space users

If you’re an Org Manager or Space Manager, go to the space with the teammate you want to remove.

On the Space page, scroll down to the “Space users” section. This has a list of all the space users. Click the “Remove All Space Roles” button.

You can also remove a user from a Space by unchecking all of their space roles.

If you’re an Org Manager or Space Manager, here’s how to remove teammates from your orgs and spaces. You can check whether you’re an Org Manager using cf org-users <org> and whether you’re a Space Manager using cf space-users <org> <space>.

Check what version of the CLI you’re running: cf -v. If that’s older than the latest version listed here, you should upgrade it to avoid unexpected errors.

Organization users

To remove teammates from your organization, run the following:

  1. Show your org info, by running:

    cf org <org>
    
  2. List the spaces belonging to the org, by running:

    cf spaces
    
  3. List the users and roles for each space, by running:

    cf space-users <org> <space>
    
  4. Remove the user for each combination of space and role, by running:

    cf unset-space-role <email> <org> <space> <role>
    
  5. Find the org GUID, by running:

    cf org --guid
    
  6. Use the API to remove the user from the org, by running:

    cf curl -X DELETE '/v2/organizations/<ORG_GUID>/users' -d '{"username": "<email>"}'
    

Space users

To remove teammates from your space, run the following:

  1. Show your org info, by running:

    cf org <org>
    
  2. List the spaces belonging to the org, by running:

    cf spaces
    
  3. List the users and roles for each space, by running:

    cf space-users <org> <space>
    
  4. Remove the user for each combination of space and role, by running:

    cf unset-space-role <email> <org> <space> <role>