Skip to content

Teams

A team is a group of colleagues working under one Tango plan. Everyone on the team gets the team's plan, and the team's daily, burst, and premium query limits are pooled: one shared allowance that every member draws from. Each person keeps their own account, API keys, and usage.

Availability

Creating a team takes a Medium plan or above on your own account. There's no limit on how many people a team can have.

Some teams run on a plan MakeGov sets by agreement, such as an invoiced Enterprise plan. MakeGov sets those teams up and manages their plan; email [email protected] to start one.

You manage your team from the Team page in your account: tango.makegov.com/account/team/.

What a team shares

Shared across the team Kept per person
The plan: its limits, features, and tier-gated fields Your account and sign-in
Daily and burst (per-minute) rate limits Your API keys
Premium query budgets Your usage, which owners and admins can see
The alert limit Your alerts and webhook endpoints
eBuy contract links made to the team eBuy contract links made to you

While you're on a team, the team's plan is your plan. It replaces your own plan rather than adding to it.

Your company is the team's name. While you're on a team, your profile shows the team's name as your company, and the Company field can't be edited. Your own company comes back when you leave.

How limits count on a team

  • Adding people divides the limits. A team has no member limit, but its plan's limits stay the same however many people share them, so each new member draws from the same pool.
  • One pool. Every request a member makes, with any of their API keys or OAuth2 tokens, counts against the team's daily and burst limits. A request to an endpoint with a premium query budget counts against the team's budget for that endpoint family instead.
  • Headers report the pool. The X-RateLimit-* headers on your responses show the team's remaining allowance, not yours alone, so a teammate's traffic lowers what you see.
  • A 429 says it's shared. When a pooled limit runs out, the 429's detail ends with "This limit is shared by everyone on your team;" followed by a link to your Team page, which shows who to contact.
  • Alerts count team-wide. The team's alert limit counts every member's alerts together, paused ones included. Alerts and webhook endpoints still belong to the person who created them.
  • Owners and admins see usage per person. The Team page shows each member's requests for today and the last 30 days.

Creating a team

  1. Make sure your own account is on Medium or above, and that you're not already on a team.
  2. Open the Team page and create a team. Team names are unique across Tango, ignoring case, and can be up to 200 characters.
  3. Invite your colleagues.

You become the team's owner and its billing owner: the team's plan follows yours. See Billing.

Roles and permissions

A team has three roles: owner, admin, and member.

Action Owner Admin Member
Use the team's plan and limits ✓ ✓ ✓
Invite members ✓ ✓ —
Invite admins ✓ — —
Resend or withdraw any pending invitation ✓ ✓ —
Remove a member ✓ ✓ —
Remove an admin or an owner ✓ — —
Promote a member to admin ✓ ✓ —
Make someone an owner, or change an admin's or owner's role ✓ — —
Rename the team ✓ — —
See each member's usage ✓ ✓ —
Leave the team ✓ ✓ ✓
  • Nobody is invited as an owner. Invite them as an admin or member, then make them an owner once they've joined.
  • Handing over billing is the billing owner's alone. See Billing.
  • A team always keeps an owner and a billing owner. The billing owner can't leave, be removed, or stop being an owner until they hand billing to another owner. The last owner can't leave or be demoted until they make someone else an owner.

Inviting people

Owners and admins invite people by email address from the Team page.

  • An invitation expires 7 days after it was last sent.
  • Resend sends a fresh link, which replaces the old one, and restarts the 7 days. You can resend once every 10 minutes, and an invitation can go out 4 times in all.
  • Withdraw an invitation to make its link stop working.
  • Limits: a team can have 20 pending invitations at once, and can send 50 invitation emails in 24 hours; one person can send 100 in 24 hours.

Accepting an invitation

To accept, you need a Tango account where the invited email address is verified.

  • No account yet? The invitation link offers to create one. Sign up with the invited address.
  • Signed in with a different address? Sign out and continue with the invited address, or ask the person who invited you to invite the address you use.
  • Address on your account but not verified? Sign out, then sign in with a code sent to the invited address. That verifies it, and you can accept from there.

Pending invitations also appear on your account pages once the invited address is verified on your account, so you can accept without the link.

You can decline from the invitation link, signed in or not. The person who invited you is emailed; if they no longer run the team, its owners are.

One team per person

You can be on one team at a time. If you're already on a team, leave it before you accept another invitation; the invitation stays open until it expires. Joining or creating a team withdraws any other invitations open to you.

Billing

A self-serve team's plan follows its billing owner's own plan. If the billing owner is on Medium, the team is on Medium, and when they change plans, the team follows. Members other than the billing owner aren't charged for the team: their Billing page says the team covers them and names who manages the plan.

Handing over billing. The billing owner can hand billing to another owner, whose own account must be active and on Medium or above. The team's plan then follows the new billing owner's plan.

If the billing owner drops below Medium, including when a payment fails and their subscription goes past due, or their account is deactivated, the team is paused right away:

  • Every member is back on their own plan and limits, and nothing is pooled.
  • The team can't send invitations or add anyone.
  • Every member is emailed, with who to contact.

The team resumes on its own once the billing owner is back on Medium or above, or once billing passes to an owner who is.

Teams on a plan MakeGov sets don't follow anyone's plan. To change the plan or who's billed, email [email protected].

Who to contact

About Contact
The team's plan The billing owner, or [email protected] for a plan MakeGov sets
Anything else about the team An owner
Closing the team [email protected]

The Team page shows each member's role and who the billing owner is.

Leaving a team

Leave from the Team page. If you're the billing owner or the last owner, hand those over first (see Roles and permissions).

When you leave, or an owner or admin removes you:

  • Your own plan and limits apply to you again, starting immediately.
  • Your API keys keep working, on your own limits.
  • Your alerts and webhook endpoints stay yours.
  • Your profile shows your own company again.

Someone who's removed gets an email saying so.

What isn't self-serve yet

  • Closing a team. Email [email protected]. If you're the only one left on the team, that's the only way out.
  • Being on more than one team at a time.