Limit a grant
Pin a token or app to clusters, sites or environments, restrict its IP addresses and set its expiry.
On this page
Scopes say what a grant may do. These three limits say where, from which addresses and for how long.
| Limit | In the dialog | Default |
|---|---|---|
| Pins | Where it works | Everything in your organisation |
| IP allow-list | IP addresses | Any address |
| Expiry | Expires | 90 days |
Set them when you create a token or approve an app, and change them later with Edit restrictions… in the grant's … menu. MCP and API access has the steps, and Sign in and tokens says who can change a grant.
Pins
Choose Only what I choose, then tick clusters, sites or environments. A pinned grant reaches only what at least one pin covers.
| Pin | Covers |
|---|---|
| Cluster | The cluster and every site and environment in it, including ones added later. |
| Site | The site and all its environments, including ones added later. |
| Environment | That environment only. |
To keep commands off production, pin only a staging environment.
A pinned grant:
- cannot create a cluster or a standalone CoreStack site;
- can add a site to a cluster only when that cluster is pinned;
- can change a whole cluster (package, capacity, delete) only with the cluster's pin, or a site pin on every site in it;
- can delete a site only with a site or cluster pin, never an environment pin;
- cannot change organisation-wide settings, such as the Cloudflare connection or Marketplace keys;
- can still read your organisation's details, with lists narrowed to its pins.
A grant holds up to 500 pins. A pin whose target is deleted never widens the grant.
A call outside the pins answers pin_refused with a link that opens Edit restrictions with the missing site or cluster already added. For a create or an organisation-wide change, the link offers everything in your organisation instead.
IP allow-list
Add up to 100 IPv4 or IPv6 addresses or CIDR ranges, for example 198.51.100.0/24. Requests from any other address are refused.
Cloud apps such as claude.ai and ChatGPT connect from their own servers, so an office list blocks them.
Expiry
Choose 7 days, 30 days, 90 days, 365 days, On a date… or Never. Revoke access says what stops when a grant ends.