Bixby Developer Center

References

restricted

optional

Only allows specific capsules or organizations to use the declared required permissions. Restricted permissions can only be accessed by the following:

  • Capsules belonging to organizations explicitly enumerated with their namespace using the org keys under restricted.
  • Other individual capsules explicitly enumerated with capsule keys under restricted.

Example

This endpoint requires the contacts permission, which can only be granted to capsules belonging to the bixby organization and the samsung.coolThing capsule:

...
action-endpoint (GetContactPermission) {
accepted-inputs ()
local-endpoint (GetContactPermission.js)
required-permissions {
permission (contacts) {
restricted {
org (bixby)
capsule (samsung.coolThing)
}
}
}
}
...

Note that org and capsule can be mixed. However, if you specify an organization with org, you should not specify any individual capsules within that organization; they are automatically included.

Child Keys

capsule
optional
A capsule that should be granted restricted permissions
org
optional
An organization name that should be granted restricted permissions