Member Directory programs: deactivate, deprovision, provision
The Member Directory Verbs deactivate, deprovision, provision as MCP do programs, with inputs, result, refusals and an example.
Reference for Member Directory, one group of Member Directory programs.
MemberDirectory.deactivate
Deactivate stops a Member Directory’s pushes; everyone it added keeps their Roles until an admin removes them. Verb page.
do: return await $.MemberDirectory.deactivate(input)Emits MemberDirectory.deactivated.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
directory | Member Directory | required | The Member Directory to turn off. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
directory | Member Directory | required | The Member Directory, now inactive. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
Example
{
"name": "do",
"arguments": {
"code": "return await $.MemberDirectory.deactivate({ directory: 'directory_qZldlwGLVN' })"
}
}MemberDirectory.deprovision
Deprovision ends one person’s access to a Tenant in one Action when the Customer’s directory removes them. Verb page.
do: return await $.MemberDirectory.deprovision(input)Emits MemberDirectory.deprovisioned.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
directory | Member Directory | required | The Member Directory that removed the person. |
person | Person | required | The person removed. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
person | Person | required | The person, with no Role left in the Tenant. |
memberDirectory | Member Directory | required | The Member Directory that removed the person. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
Example
{
"name": "do",
"arguments": {
"code": "return await $.MemberDirectory.deprovision({ directory: 'directory_qZldlwGLVN', person: 'person_sLqbXbW683' })"
}
}MemberDirectory.provision
Provision starts a Customer’s Member Directory pushing people and groups into its Tenant, with groups mapped to Roles. Verb page.
do: return await $.MemberDirectory.provision(input)Emits MemberDirectory.provisioned.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
tenant | Tenant | required | The Tenant it fills. |
groupRoles | json | Which group fills which Role. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
directory | Member Directory | required | The Member Directory, now active. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
Example
{
"name": "do",
"arguments": {
"code": "return await $.MemberDirectory.provision({ tenant: 'ten_Bu63f0he26' })"
}
}