Organizations & Teams
Organizations let you collaborate with teammates under a single billing account. Every PromptGuard user starts with a personal organization. You can create additional team organizations, invite members, and control access with role-based permissions.Concepts
Roles & Permissions
Getting Started
Create a Team
- Go to Organization → Team
- Click “Create Team”
- Enter a team name
- Your new organization appears alongside your personal organization
Invite Members
- Navigate to Organization → Team
- Under Invitations, enter the email address and select a role
- Click Send Invitation
- The dialog that follows shows the invitation’s accept link. Copy it now if you want to send it yourself: it is shown this once, and never again, not even on a resend
- “We emailed” means our mail provider accepted the message, not that it arrived. A typo’d address, a spam filter or a full mailbox all look the same from here. In the pending list an invitation shows Sent with a date once the mail provider has accepted it, or Never delivered if it did not. When the email could not be sent at all, the dialog says so and the link is the way to reach them.
- Only the invited address can accept. The person must sign in with exactly that email address; anyone else who opens the link is told which address it was sent to. So an invitation to a mistyped address cannot be fixed: revoke it and invite the right address.
- One pending invitation per address. Inviting an address that already has a pending invitation is refused with
409 Conflict. Resend the existing one, or revoke it first. - Resend re-mails the same invitation. It uses the same link, and does not extend the expiry.
- Invitations expire 7 days after they are created, and each one can be used once. To give someone more time, revoke the invitation and invite them again.
Switch Organizations
Use the organization selector at the top of the dashboard sidebar to switch between your personal organization and team organizations.Managing Members
Change a Member’s Role
- Go to Organization → Team
- Find the member in the Members table
- Select the new role from the dropdown
- Confirm the change
Remove a Member
- Go to Organization → Team
- Click the remove button next to the member
- Confirm removal
Project-level access
Organization roles apply across all projects. For finer-grained control, you can grant a user a role on a single project: useful when a contractor or a partner team should see one project without access to the rest of your organization.Per-project roles are on every plan, Free included (Pricing).
Project roles
How access is resolved
A user’s effective access to a project is the highest of:- Project ownership: the user who created the project is its owner.
- Their organization role: organization Owners and Admins are automatically Admins on every project; organization Members and Viewers carry that role into each project.
- Any explicit project role granted below.
Grant a project role
- Open the project, then go to its Settings → Access tab
- Enter the teammate’s email and choose a project role
- Click Add: the change takes effect immediately
Project Members API
These endpoints live under/dashboard/projects/{project_id} and use the session token.
/dashboard/* takes a dashboard sign-in, not an API key. These endpoints are the API the dashboard at app.promptguard.co calls. They are not part of the public API, and no API key or long-lived token works on them. Everything under /api/v1 takes your X-API-Key instead (API reference).To script one anyway, sign in with your email and password. This needs an account that has a password, and an email domain that requires SSO is refused. The access token lasts one hour.YOUR_SESSION_TOKEN or YOUR_SESSION_COOKIE, it means the access_token from step 1, sent as Authorization: Bearer <token> or as the access_token cookie. A request acts on your personal organization unless it sends X-Organization-Id.Managed service providers
This section is for the client’s side of the relationship. If you are the provider, the Managed service providers guide walks through running PromptGuard for your clients end to end. A managed service provider (MSP) can manage your organization on your behalf, through a grant: a record that lets the provider’s organization act in yours with one role, such as Admin or Viewer. The provider’s staff never join your organization and never share your logins; they act from their own organization, and every action is theirs in your audit log. A grant follows the same rules as Microsoft’s granular delegated admin privileges (GDAP): the least role that does the job, for a limited time, and only with your agreement.- You approve it first. If your organization has an owner, a grant over it starts as Awaiting approval and gives the provider nothing until your owner or an admin approves it. Declining ends it.
- It can end on a date. A grant may carry an end date. From the end of that day (UTC) the provider can do nothing in your organization, without anyone having to revoke it. Your devices, events and history stay yours.
- You can see it and end it at any time. Every grant over your organization is listed with its role, start, end date and state.
Approve, decline or end a provider’s access
- Switch to your organization and go to Dashboard > Settings > Team
- Under Managed by, each provider shows its role, since when, until when, and its state: Active, Awaiting approval or Expired
- Click Approve or Decline on a request, or End access on any other grant
Set when a client loses access, for providers
On Dashboard > Clients, each client shows when your access ends. End date sets, moves or clears it.- For a client you created, you can set any future date, move it later, or remove it. Setting a later date on an expired grant restores your access.
- For a client that approved your access, you can bring the date earlier but not later: the client agreed to a window, and more access needs a new grant that the client approves.
Ending a provider’s access takes its authority at its next request. It does not revoke enrolment tokens or API keys created in your organization while the provider had access: those belong to your organization. Rotate them as a separate step when a relationship ends.
Ownership
Transfer Ownership
- Go to Dashboard > Settings > Team > Danger Zone
- Click “Transfer Ownership”
- Select the new owner from existing members
- Confirm the transfer
Delete an Organization
- Go to Dashboard > Settings > Team > Danger Zone
- Click “Delete Organization”
- Type the organization name to confirm
API Reference
The Organizations API is session-authenticated (Dashboard API). All endpoints live under/dashboard/organizations.
List Organizations
Create Organization
Invite a Member
Update Member Role
Remove a Member
Transfer Ownership
Delete Organization
Best Practices
- Use the least privilege role — assign Viewer to stakeholders who only need read access
- One organization per team — avoid mixing production and personal projects
- Rotate ownership proactively — transfer ownership before an owner leaves the company
- Audit members regularly — remove inactive members to reduce your attack surface
Next steps
Single sign-on
Sign in through your identity provider with SAML or OIDC
Directory sync (SCIM)
Provision and deprovision members from your IdP
Audit logs
The tamper-evident record of administrative actions