Update productivity assistant
Changes the fields you send and returns the full updated assistant.
Send only the fields you want to change, plus version with the num from your last read. A field you leave out keeps its stored value, an explicit null clears it, and every list is replaced whole. The assistant’s id goes in the URL; if you also send id in the body it must match.
For the rules that apply to specific fields, see How productivity assistant updates behave.
Authentication
JWT bearer token authentication. Include the Configuration API key in the Authorization header as ‘Bearer <token>’.
Path parameters
The id of the productivity assistant, as returned when it was created or listed.
Request
Name of the assistant’s icon in the Moveworks icon set, as the Studio creator stores it (e.g. MWIconPublic). Not a URL.
Plugins the assistant may use, by plugin identifier (a native plugin name such as enterprise_search_plugin, or a Tool Studio plugin id). Empty means no plugins.
Which skills the assistant may use: ALL includes every skill, including ones registered later; SELECTED uses only skill_ids. Unset on create stores SELECTED, so nothing is granted by omission; reads return ALL for assistants stored without a mode.
Skills the assistant may use when skill_access_mode is SELECTED. ID of an existing skill (GET /configurations/v1alpha1/assistant/skills).
MCP servers whose tools the assistant may call. ID of an existing mcp_server (GET /configurations/v1alpha1/platform/extensions/mcp-workspace/servers).
External A2A agents the assistant may delegate to. ID of an existing A2AAgentConfig; not available through the Configuration API.
Who can use the assistant. Exactly one of allow_all, allowed_emails or allowlist_rule_dsl; required on create. The creator always retains access.
Response
Name of the assistant’s icon in the Moveworks icon set, as the Studio creator stores it (e.g. MWIconPublic). Not a URL.
Plugins the assistant may use, by plugin identifier (a native plugin name such as enterprise_search_plugin, or a Tool Studio plugin id). Empty means no plugins.
Which skills the assistant may use: ALL includes every skill, including ones registered later; SELECTED uses only skill_ids. Unset on create stores SELECTED, so nothing is granted by omission; reads return ALL for assistants stored without a mode.
Skills the assistant may use when skill_access_mode is SELECTED. ID of an existing skill (GET /configurations/v1alpha1/assistant/skills).
MCP servers whose tools the assistant may call. ID of an existing mcp_server (GET /configurations/v1alpha1/platform/extensions/mcp-workspace/servers).
External A2A agents the assistant may delegate to. ID of an existing A2AAgentConfig; not available through the Configuration API.
Who can use the assistant. Exactly one of allow_all, allowed_emails or allowlist_rule_dsl; required on create. The creator always retains access.