Organization Management

Create and manage organizations, invite members, and assign roles in the Jinba Toolbox console

Organizations are the top-level ownership unit in Jinba Toolbox. Every ToolSet, API key, and execution record belongs to an organization. You must create or join an organization before you can start building tools.

Creating an Organization

1. Open the Dashboard

   After signing in, navigate to the Dashboard page. You will see a list of organizations you belong to. If this is your first time, the list will be empty.

2. Click Create Organization

   Click the New Organization button. A form will appear asking for:

   • Name — A human-readable name for your team or project (e.g. “Acme Engineering”).
   • Slug — A URL-safe identifier auto-generated from the name (e.g. acme-engineering). You can customize it before creation.
3. Confirm Creation

   Click Create. You will be redirected to the new organization’s ToolSets page, ready to start building.

Organization Dashboard

Once inside an organization, the sidebar provides access to all management areas:

ToolSets

View, create, and manage your ToolSets. This is the default landing page for an organization.

Runs

Browse the execution history of all tools within the organization.

Members

Invite team members and manage their roles.

API Keys

Create and revoke API keys scoped to this organization.

Credits

View your credit balance, purchase credits, and review transaction history.

Settings

Edit the organization name or delete the organization.

Member Management

Inviting Members

Only users with the Owner or Admin role can invite new members.

1. Navigate to Members

   Go to Members in the organization sidebar.

2. Click Invite

   Click the Invite Member button at the top of the page.

3. Enter Details

   Provide the email address of the person you want to invite and select a role: Owner, Admin, or Member.

4. Send Invitation

   Click Send. An invitation email will be sent. The pending invitation will appear in a separate section on the Members page until the user accepts it.

Accepting an Invitation

When a user receives an invitation:

1. They click the link in the email, which opens the /invite/[id] page.
2. If they are not signed in, they are prompted to log in or sign up.
3. Once signed in, they click Accept to join the organization.
4. After acceptance, they are redirected to the organization page.

Invitations that are expired, cancelled, or sent to a different email address will display an error.

Roles and Permissions

Each member is assigned one of the following roles:

Permission	Owner	Admin	Member
Create / edit / delete ToolSets and Tools	Yes	Yes	Yes
Execute and test tools	Yes	Yes	Yes
View run history	Yes	Yes	Yes
Manage API keys	Yes	Yes	No
Invite and remove members	Yes	Yes	No
Change member roles (below own level)	Yes	Yes	No
Edit organization settings	Yes	Yes	No
Delete the organization	Yes	No	No

Every organization must have at least one Owner. You cannot remove the last remaining owner.

Changing a Member’s Role

Owners and Admins can change the role of any member whose current role is below their own. For example, an Admin can change a Member to Admin, but cannot change another Admin to Member.

Removing a Member

Click the remove action next to a member’s name on the Members page. A confirmation dialog will appear. Removal is immediate.

Organization Settings

Navigate to Settings in the sidebar to:

• Rename the organization (Owner and Admin only).
• Delete the organization (Owner only). Deletion requires typing the organization name for confirmation and is irreversible — all ToolSets, tools, versions, runs, and API keys will be permanently removed.

Best Practices

• Use organizations to group related teams or projects. Each organization has its own ToolSets, API keys, and billing.
• Follow the principle of least privilege. Assign the minimum role needed for each member.
• Review members regularly. Remove access for users who no longer need it.
• Keep at least two Owners for redundancy in case one becomes unavailable.