Use this tool to list, grant, update, or revoke a monday platform agent's access to boards and docs. An agent's "knowledge" is the set of monday.com boards and docs it can read from or write to during a run.

🚧
This tool runs against the monday.com dev (preview) API schema.

Action	Required fields	Description
`list`	`agent_id`	Returns all resources the agent has access to, including permission level and resource type.
`add`	`agent_id`, `resource_id`, `scope_type`, `permission_type`	Grants access to a board or doc.
`update`	`agent_id`, `resource_id`, `scope_type`, `permission_type`	Changes the permission level on an existing resource.
`remove`	`agent_id`, `resource_id`, `scope_type`	Revokes the agent's access to a board or doc.

For update and remove, call action: "list" first to confirm the resource_id exists.

Parameters

Parameter	Type	Required	Description
action	`enum`	Yes	One of `list`, `add`, `update`, `remove`.
agent_id	`string`	Yes	Unique identifier of the agent.
resource_id	`string`	Conditional	Required for `add`, `update`, `remove`. The ID of the board or doc to grant/update/revoke access to.
scope_type	`enum`	Conditional	Required for `add`, `update`, `remove`. The resource type: `BOARD` or `DOC`.
permission_type	`enum`	Conditional	Required for `add` and `update`. `READ` (agent can read) or `READ_WRITE` (agent can read and write).

Examples

Grant an agent read access to a board:

{
  "action": "add",
  "agent_id": "7",
  "resource_id": "42",
  "scope_type": "BOARD",
  "permission_type": "READ"
}

Upgrade that access to read-write:

{
  "action": "update",
  "agent_id": "7",
  "resource_id": "42",
  "scope_type": "BOARD",
  "permission_type": "READ_WRITE"
}

Related tools

manage_agent — manage the agent entity itself.
manage_agent_triggers — manage which triggers fire this agent automatically.
manage_agent_skills — manage which skills this agent can perform.

Programmatic equivalent

This tool maps to the agent_knowledge query and add_agent_resource_access / update_agent_resource_access / remove_agent_resource_access mutations on the monday.com dev (preview) API schema. There is no stable public GraphQL equivalent yet.