Set permissions
Control which sellers may sell your offers and into which countries.
Set permissions
As an Originator you decide who may sell your stock and where. Permissions live on the offer and are enforced on every read by any partner entity.
The permissions object
{
"network_shareable": true,
"permissions": {
"allowed_countries": ["DE", "CH", "AT"],
"named_sellers": ["ent_8f...", "ent_2a..."],
"default": "none"
}
}
| Field | Meaning |
|---|---|
network_shareable |
false → the offer is invisible to every entity except your own |
allowed_countries |
ISO-3166 alpha-2 codes a seller may sell into |
named_sellers |
explicit allow-list of seller entity ids |
default |
any (open to all sellers, subject to countries) or none (closed; only named sellers) |
Common patterns
| Pattern | network_shareable |
allowed_countries |
named_sellers |
default |
|---|---|---|---|---|
| Open to the network, EU only | true |
["DE","FR","IT",…] |
[] |
any |
| Named partners only | true |
[] |
["ent_…"] |
none |
| Private (internal only) | false |
[] |
[] |
none |
Enforcement
Permissions are not cosmetic. For every read, the API evaluates network_shareable and the caller's entity
against allowed_countries / named_sellers / default, and omits non-matching rows before serialisation. A
seller outside your permissions never receives the row — not even its id. See
Data-exposure controls.