Application users, permissions and organizations
On this page
Choose preview or production deliberately. An organization entity is the customer organization; its slug identifies that boundary in supported tool arguments.
Use these tools
- Call the relevant read or status tool first.
- Review the target and required arguments.
- Run one intended action, with explicit human confirmation where required.
- Inspect status or re-read the affected resource afterward.
Inputs below describe the public contract. Your connected server’s current tool list is authoritative. Some tools require a particular host, target, inference mode or plan. Identifiers are values returned by earlier tools; do not invent them.
app_users
The generated app’s users.
Read the returned resource and use its current values when planning the next action.
| Argument | Required | Type or accepted values |
|---|---|---|
projectId | No | string |
scope | No | ephemeral, production |
all | No | boolean |
Operation: read-only.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
manage_app_user
Invite, update or remove an app user.
User removal or disabling can end access. Review scope and the selected profile before confirming destructive changes.
| Argument | Required | Type or accepted values |
|---|---|---|
projectId | No | string |
scope | No | ephemeral, production |
action | Yes | invite, update, remove |
email | No | string; minLength 3; maxLength 254 |
name | No | string; minLength 1; maxLength 128 |
role | No | string; minLength 1; maxLength 32 |
disabled | No | boolean |
profileId | No | string; minLength 1; maxLength 256 |
confirm | No | boolean |
Operation: can change state or start work; destructive effects are possible.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
app_permissions
The generated app’s permissions.
Read the returned resource and use its current values when planning the next action.
| Argument | Required | Type or accepted values |
|---|---|---|
projectId | No | string |
scope | No | ephemeral, production |
Operation: read-only.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
set_app_permission_default
Set a permission’s default holder.
Changes who receives a permission by default. Test an allowed and a denied user afterward.
| Argument | Required | Type or accepted values |
|---|---|---|
projectId | No | string |
scope | No | ephemeral, production |
permission | Yes | string; minLength 1; maxLength 128 |
defaultClass | No | none, user, member, owner |
entityScoped | No | boolean |
Operation: can change state or start work.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
app_grants
Who holds which permission in the generated app.
Read the returned resource and use its current values when planning the next action.
| Argument | Required | Type or accepted values |
|---|---|---|
projectId | No | string |
scope | No | ephemeral, production |
profileId | No | string; minLength 1; maxLength 256 |
group | No | string; minLength 1; maxLength 128 |
entitySlug | No | string; minLength 1; maxLength 63 |
Operation: read-only.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
manage_app_grant
Grant or revoke a permission in the generated app.
Grant or revoke only the intended permission and audience. Use entitySlug for a customer organization boundary.
| Argument | Required | Type or accepted values |
|---|---|---|
projectId | No | string |
scope | No | ephemeral, production |
action | Yes | assign, revoke |
permission | Yes | string; minLength 1; maxLength 128 |
profileId | No | string; minLength 1; maxLength 256 |
group | No | string; minLength 1; maxLength 128 |
entitySlug | No | string; minLength 1; maxLength 63 |
resources | No | array of string |
mode | No | blanket, resources, all |
Operation: can change state or start work; destructive effects are possible.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
app_organizations
The generated app’s organizations.
Read the returned resource and use its current values when planning the next action.
| Argument | Required | Type or accepted values |
|---|---|---|
projectId | No | string |
scope | No | ephemeral, production |
entitySlug | No | string; minLength 1; maxLength 63 |
Operation: read-only.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
manage_app_organization
Rename an organization or manage its members.
Manages customer organization titles and membership. Confirm the intended organization entity and user.
| Argument | Required | Type or accepted values |
|---|---|---|
projectId | No | string |
scope | No | ephemeral, production |
action | Yes | rename, add-member, update-member, remove-member |
entitySlug | Yes | string; minLength 1; maxLength 63 |
title | No | string; minLength 1; maxLength 256 |
email | No | string; minLength 3; maxLength 254 |
name | No | string; minLength 1; maxLength 128 |
owner | No | boolean |
profileId | No | string; minLength 1; maxLength 256 |
groups | No | array of string |
Operation: can change state or start work; destructive effects are possible.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
app_groups
The groups of an organization in the generated app.
Read the returned resource and use its current values when planning the next action.
| Argument | Required | Type or accepted values |
|---|---|---|
projectId | No | string |
scope | No | ephemeral, production |
entitySlug | Yes | string; minLength 1; maxLength 63 |
group | No | string; minLength 1; maxLength 128 |
Operation: read-only.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
manage_app_group
Create, change or delete a group, or manage its members.
Group membership and permission bundles affect user access. Check the group and scope before changing or deleting it.
| Argument | Required | Type or accepted values |
|---|---|---|
projectId | No | string |
scope | No | ephemeral, production |
action | Yes | create, update, delete, add-members, remove-members |
entitySlug | Yes | string; minLength 1; maxLength 63 |
group | Yes | string; minLength 1; maxLength 128 |
title | No | string; minLength 1; maxLength 256 |
bundles | No | array of object |
profileIds | No | array of string |
confirm | No | boolean |
Operation: can change state or start work; destructive effects are possible.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.