Developer Teams and Developer Team Apps

What are Developer Teams and Developer Team Apps?

Developer Teams and Team apps help you self-organize based on how your company or project is structured.

A Developer Team (or "Teams" in the Developer Portal) allows for multiple developers to collaborate on a shared set of applications - allowing teams of developers to work together on projects, sharing the ownership and access to their applications and associated API keys (aka Client ID and Client Secrets). Developer Teams provide a simple, secure approach to API management by providing a structured way to organize and manage access to groups of developers, rather than individuals. 

A Developer Team App is an application registered and managed by a Developer Team. Responsibility for the app and its associated API keys is shared amongst all members of the Developer Team. 

Who should create a Developer Team?

Any registered user of the USCIS Torch API Developer Portal can create a Developer Team.

Keep in mind, you must consult with your product team prior to creating the Developer Team to avoid any redundancy. Most teams will appoint a primary point of contact or lead to take on this responsibility. When the Developer Team is created, add members to your team and send email invitations to each unique developer registered to the USCIS Torch Developer Portal. 

Provided in the Scenarios Section below are common use cases for Developer Teams.

Scenarios

Below are common scenarios (not limited to) that help illustrate the flexibility of Developer Teams and Team Apps. Please contact [email protected] if you have any questions on how to set up your Developer Team.

Creating a Developer Team

To create a Developer Team:

1. Login to the USCIS Torch API Developer Portal
2. Click on Teams
3. Click on Add team
4. Enter Team Name. Avoid special characters. Don't include environment or product specifics (ex: prod, stage etc.)
5. Click on Add team to create your team.

Adding Team Members to a Developer Team

To add Team Members to a Developer Team:

1. Click on Teams
2. Find and click on the Team name
3. Click on Members
4. Click on Invite Members
5. Enter the email address(es) of each unique developer to invite
6. Click on Invite Members

Advise your product team members to check their email for the incoming Developer Team Invitation. All developers MUST accept the Team Invitation to join.

Team Owners can manage the invitation from this screen to view, revoke or resend invitations.

How do I Get Added to an Existing Team?

Any existing team member can add you to the team following the steps in Adding Team Members to a Developer Team (above).

Removing Team Members from a Developer Team

To remove Team Members from a Developer Team:

1. Click on Teams
2. Find and Click on the Team name
3. Click on Members
4. Locate the Team Member from the table
5. Under the Operation Column, click on the drop down
6. Click on Remove
7. Confirm removal of the Member

Creating Developer Team Apps

To create a Developer Team App for a Developer Team:

1. Click on Teams
2. Find and Click on the Team name
3. Click on Team Apps
4. Click on Add Team App
5. Enter the App Name
6. Select which API products you want to associate to the app
7. Click on Add team app to create your team app