Uh oh! We couldn’t find any match.

Please try other search keywords.

Bixby Developer Center

Guides

Managing Teams & Capsule Access

With Teams & Capsules, you can perform tasks like managing your teams and their members, registering new capsules, and determining read and write access by team members to capsules. This guide walks through these and other essential steps.

Create or Join a Team

Note

You're currently limited to creating three teams. If you need more than three teams, please contact Bixby support.

Your capsule is uniquely identified within Bixby by its ID, which is composed of an organizational namespace and a capsule name.

For example, if the capsule ID is example.shirt, the organizational namespace is example and the capsule name is shirt.

Your namespace is unique within the Bixby ecosystem. You must register it when when you create a team in the Bixby Developer Center, which is a required step if you want to submit your capsule to the Bixby marketplace.

You specify your capsule ID in your capsule descriptor, which is the capsule.bxb file.

If you are creating a team for the first time, simply select the Create a New Team button on the front page of Teams & Capsules. You can then provide team details about your team such as the name, website, email, and namespace. If you aren't a team admin, you might be invited through email to join an existing team.

If you are just starting and you want to execute and debug your capsule using the simulator or with stories, you can use the playground namespace. Another special namespace is example, which is used for sample capsules. However, you cannot submit capsules that use these special namespaces. Once you have tested your capsule using these special namespaces, and you are ready to submit your capsule, you should follow the normal process here to create a team, register a capsule, and update your capsule ID in your capsule.bxb file.

Note

Your team's ability to execute capsules in Bixby Developer Studio, view submissions and submission details, or submit capsules depends on whether you have the correct permissions. Therefore, ensure that you register a namespace, your capsules are registered under that namespace, and the appropriate team members are collaborators for those capsules.

Edit Profile Info

Regardless of your permissions, you can edit your profile to add a display name and profile picture. This allows fellow team members to better identify you.

  1. Select Open Account Info from the drop-down menu in the upper-right corner of the screen.
  2. Select Edit Profile.
  3. Edit your display name and time zone.
  4. Select Save Changes.

    Edit Team Info

    Note

    To edit Samsung Account information, such your name or phone number, select the Open Samsung Account Page button.

Add Team Members

If you are an admin of an existing team, you can invite others as members or admins using their email address:

  1. Select the People tab within Teams & Capsules.
  2. Select the Add Member button.
  3. Type the email or emails of team members you want to add.
  4. Choose whether the invited person should be a member or an admin.
  5. Select Submit.

    Add Team Members

Edit Team Info

If you are an team admin, you might need to update team information, such as the team name, website, or team logo.

  1. Select the Team Info tab within Teams & Capsules.
  2. Edit information such as display name and time zone.
  3. Select Save Changes.

    Edit Team Info

Register a Capsule

As a team admin, you can register a capsule, which allows any collaborator to submit it.

  1. Select the Capsules tab within Teams & Capsules.
  2. Click the + Register Capsule button.
  3. Type the capsule ID.
  4. Select Submit.

    Note

    You can only use letters, numbers, and underscores for a capsule ID.

    Register Capsule

You must use the fully-qualified name of the capsule ([TEAM_NAMESPACE].[CAPSULE_ID]) within your capsule.bxb file. Example: id (playground.gratuity)

Add Collaborators

Once you've added team members and capsules, you can add collaborators on each capsule. This allows them to edit capsule code, submit capsules, and view capsule submissions.

  1. Select the Capsules tab within Teams & Capsules.
  2. Select the capsule for which you want to add collaborators.
  3. Select the + sign in the upper-right corner.
  4. Choose a team member from the list. You can search for the member as well.
  5. Select Save Changes.

    Add Collaborators

In addition to adding collaborators, you can also remove them from a capsule.

Permissions

Here is a summary of the permissions you have depending on whether you are a team member, or capsule collaborator, or team admin.

AbilityTeam MemberCapsule CollaboratorTeam Admin
View team membersYesYesYes
Edit profileYesYesYes
View capsules and related submissionsYesYesYes
Modify collaboratorsNoNoYes
Submit capsulesNoYesYes
Register capsulesNoNoYes
Edit team informationNoNoYes
Edit team members and adminsNoNoYes
Note

These permissions are not mutually exclusive, which means, for example, that you can be both a team member and a capsule collaborator.

As a developer, you can only see submissions for capsules that you are allowed to view as a capsule collaborator. This also applies to submitting capsules.