Sharing lets an agent owner give other users access without admin involvement. Pinter supports two sharing methods: Both methods create a grant with one of two privilege levels:

​
Share directly with a user

Open the agent in the builder and select Share Agent in the canvas header.
1

Open the Direct Share tab

The dialog opens on the Direct Share tab.
2

Enter the recipient

Type the recipient’s exact email or username. Pinter does not offer a user directory to browse, so the identifier must match exactly.
3

Select the privilege

Choose Use Only (Read-Only Builder) or Edit & Co-own (L1/L2 Only).
4

Share

The recipient receives an approved grant immediately.
Backend endpoint:

​
Share with a claim code

Claim codes let recipients redeem access themselves. Codes use the format PIN-SHR-XXXX-XXXX.
1

Open the claim code tab

In the Share Agent dialog, switch to the claim code tab.
2

Choose the audience

Select Team/Group to let members bind the grant to a role group, or Peer User for individual claims.
3

Set privilege, claims, and expiry

Choose Use Only or Edit & Co-own, the maximum number of claims, and an expiry of 1 hour, 24 hours, 7 days, or never.
4

Copy and distribute the code

Copy the generated code and send it to your recipients.
Backend endpoint:

​
Redeem a claim code

Recipients redeem codes from the app sidebar.
1

Open the redemption dialog

Select Redeem Claim Code in the sidebar.
2

Enter the code

Type the code in the PIN-SHR-XXXX-XXXX format. Pinter validates the code, its expiry, and the remaining claims.
3

Confirm

Review the agent name and privilege. For team codes, select the target role group before confirming. Confirmation creates an approved grant and decrements the remaining claims.
Backend endpoints:

​
See who has access

An agent’s creator can list every active grant on it, including L3 designers who cannot reach the admin mapping view:
Each item’s id is the grant id to pass to the revoke endpoint below. The response also carries is_public — when true, everyone can use the agent regardless of the grants listed, so revoking them will not restrict access. Authorised with the same check as revoking, so anyone who can see a grant here can also revoke it.

​
Revoke a shared grant

Owners and Super Admins can revoke an existing grant:
An edit grant lets the recipient change the agent for every user who runs it. Prefer use grants unless the recipient co-owns the agent.
Sharing covers owner-driven access. For admin-driven access requests and approvals, see Authentication and access control.