Update Agent Project Access
update_agent_project_accessUpdate a project agent's role or access status. Use 'removed' to disable access while preserving audit history. Requires project selection and human approval.
Instructions
Use when: Human project-manager tool: update a project-scoped agent principal role or status. Use status=removed to disable access without deleting audit history. Do not use when: a narrower tool better matches the intent, the project scope is unresolved, or the user has declined the action. Requires: authenticated API authority and an API-authorized selected Project. Effect: canonical mutation. This mutation has no client idempotency key in the current contract; do not retry it automatically after an unknown outcome. Human approval: required before this action or its canonical follow-up. Then: follow typed result state; review pending proposals/drafts before any canonical apply. On failure: login_required → login; project_not_selected → list_projects/select_project; permission_denied �� stop; stale_version or conflict → read current state; projection_pending → report canonical success separately and wait.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | Project role to grant to the agent. | |
| status | No | Optional project access status. Defaults to active when granting access. | |
| agentKey | Yes | Project-local agent key to update. | |
| projectId | No | Optional project id. Defaults to the project chosen with select_project. If omitted and no project is selected, the call is rejected with instructions to select one. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| status | Yes | ||
| warnings | Yes | ||
| authority | Yes | ||
| projectId | Yes | ||
| reviewUrl | Yes | ||
| idempotency | Yes | ||
| nextActions | Yes | ||
| reviewRequired | Yes | ||
| canonicalVersion | Yes | ||
| projectionStatus | Yes |