Managing Provider Permissions
A provider is private to its owner until it is shared. Sharing grants the aiprovider:use permission, which lets the recipients select the provider's enabled models in Chat, pw code, and external tools. It does not let them edit the provider or see its credentials.
aiprovider:use can be granted to the whole organization or to groups. There are no per-user grants: to share with specific people, put them in a group.
Who Can Use a Provider
| Provider | Can use it without a grant | Others need |
|---|---|---|
| Personal provider | Its owner | A grant to the organization or one of their groups |
| Organization provider | Organization admins | A grant to the organization or one of their groups |
| Self-hosted session | The session's owner | The session shared with the organization or one of their groups. See Self-Hosted Sessions. |
Organization admins can manage the grants on any personal provider in the organization, but they can't use a personal provider themselves unless it is shared with them. A personal provider spends its owner's credentials, so being an admin is not enough.
What Else Is Checked
A grant is necessary but not sufficient. Each request also has to pass these checks:
- AI is enabled on the platform and assigned to your organization.
- The provider's catalog entry is enabled. A provider whose entry was disabled shows Suspended by platform policy.
- The model is on the catalog entry's allowed models list, if the platform administrator set one.
- The model is enabled on the provider.
- For organization providers, the request names an allocation you can bill. See Organization Providers.
Share a Personal Provider
The provider's owner can share it from the providers list. Organization admins can share it from the provider's details page.
- Navigate to AI > Providers.
- Open the provider's row menu (or the menu on its details page) and choose Manage access.
- In the permissions dialog, check Use on the Organization row to share with everyone, or on the rows of the groups you want to share with. Use Search groups... to find a group.
- Click Save access.
The provider's Sharing detail then reads Shared with organization, Shared with N groups, or Private. Recipients find it under Shared with me on their providers page.
Share an Organization Provider
Organization providers are shared with the whole organization when they are created. To change that, open the provider's row menu under Organization providers, choose Manage access, set Allow all organization members and Groups, and click Save access. See Organization Providers.
Revoke Access
Open Manage access again, clear the Use permission (or turn off Allow all organization members, or remove the group), and save. Users who lose access no longer see the provider's models, and requests that name them are rejected. Their existing conversations remain.
Best Practices
- Share with groups first. Share a provider with the teams that need it rather than the whole organization, especially when it is backed by a paid key.
- Use clear display names. A name like "OpenAI (research team)" helps users pick the right provider in model pickers.
- Review sharing periodically. Check the Sharing detail on each provider you own.
- Rotate keys. Update the provider's API key from Edit when you rotate credentials at the vendor.
Related Documentation
- AI Providers Overview: Provider ownership and access at a glance
- Organization Providers: Access and allocations for organization providers
- Self-Hosted Sessions: Sharing models served from sessions