Identity and permissions
Use this reference with the complete developer tour and TypeScript types. The example at the end runs after the tour setup.
saveContactPermissions
Section titled “saveContactPermissions”Save the subject’s dedicated contact defaults and exceptions atomically.
saveContactPermissions(input: ContactPermissionsInput): Promise<unknown>| Parameter | Type and default | Usage |
|---|---|---|
input |
ContactPermissionsInput (required) |
Typed operation input. See its declaration in the language types reference. |
Returns: The saved policy and its new version.
Permissions, lifecycle and errors: Use the observed version and preserve deny effects. Explicit blocks override other matching grants; omission restores defaults.
Declared return type: Promise<unknown>.
Working TypeScript example. Input/output fields are in the types reference.
Example
Section titled “Example”Run this region after the shared setup. Assertions check the returned data; the full tour is a runnable program.
const subject: Target = { kind: 'agent', id: builderId };const contactPreview = readObject(await owner.previewContactPermissions({ subject }));const contactVersion = Number(readObject(contactPreview.policy).version);const contactPolicy = readObject(await owner.saveContactPermissions({subject, version: contactVersion, rules: [{action: 'view', target_kind: 'agent', target_id: billingId}]}));assert.ok(Number(contactPolicy.version) > contactVersion);