Skip to content

Sync & teams (Pro)

Cloud sync and teams are paid features. They require an active license -- see Plans below for details.

Plans

PlanPriceIncludes
FreeFreeLocal-only collections, environments, and history. No sync.
Pro£4/mo or £29 lifetimeCloud sync across devices for collections, environments, and global variables.
Team£8/seat/moEverything in Pro, plus team creation, shared collections, and team member management.

License

  • Enter your license key in the License dialog when prompted, or open it from the sidebar menu.
  • The extension validates your key with the billing provider so features stay accurate over time.
  • Pro and Team keys both unlock cloud sync. The Team plan additionally enables team creation and shared collections.

What syncs

When sync is active, the following stay aligned across your signed-in devices:

  • Collections (requests and folders)
  • Environments
  • Global variables

Use the command Gud API: Show Sync State in the Command Palette if you need to troubleshoot.

Sync review dialog

When you click Sync, Gud API shows a review dialog before applying changes. The dialog lists incoming additions, edits, and deletions so you can confirm before anything overwrites local data.

  • Conflicts are resolved inline inside the review dialog. You pick which version to keep for each conflicting item.
  • Fast-path sync applies automatically for routine changes (small, non-conflicting updates) so you are not interrupted unnecessarily.

You always stay in control of destructive actions such as deletes -- those require confirmation.

Teams

Creating a team

Creating a team requires an active Team license (£8/seat/mo). Open the Team dialog from the sidebar, choose a team name, and you become the admin.

Free and Pro users cannot create teams. However, anyone can join a team without purchasing their own license -- the admin's subscription covers every seat.

Invite codes

Admins generate invite codes from the Team dialog. Share the code with teammates through any channel (email, Slack, etc.). Recipients enter the code in their own Gud API License dialog to join.

Team member tokens

When a user without a license joins via invite code, they receive a GUDTEAM- prefixed token. This token validates against the admin's Team subscription rather than an individual license.

If the admin's subscription expires or is cancelled, all team member tokens become invalid and those members lose sync access until the subscription is renewed.

Auto-seat management

Each accepted invite automatically adds a seat to the admin's Team subscription. When a member leaves the team or the admin removes them, the seat count decrements accordingly. The admin's invoice reflects the current seat count at each billing cycle.

Roles

  • Admin -- created the team. Can invite members, remove members, and manage shared collections.
  • Member -- joined via invite code. Can leave the team and access shared collections according to their permissions.

Shared collections

Shared collections are a Team plan feature that lets team members access the same collection of requests.

Sharing a collection

Right-click any collection in the sidebar and select Share with Team. Choose a permission level:

PermissionWho can viewWho can edit
Read/writeAll team membersAll team members
Read-onlyAll team membersOwner only

Visual indicators

The sidebar shows icons next to shared collections so you can tell their status at a glance:

  • People icon -- the collection is shared with the team.
  • Lock icon -- the collection is read-only. Non-owners can view requests but cannot add, edit, or delete them.

Editing restrictions

If you are not the owner of a read-only collection, the request builder disables editing controls for requests in that collection. You can still send the request and view responses, but changes cannot be saved back.

Privacy

Before you first sync, you should understand:

  • Request data in collections and secrets in environments are stored in the cloud when you sync.
  • The extension asks you to acknowledge that risk once; the choice is stored locally by your editor.

If you are not comfortable with cloud storage, you can use Gud API without a paid plan and keep everything local.