Create productivity assistant
Creates a productivity assistant and returns it with its id and version.
Send the assistant’s fields at the top level of the JSON body. name, user_access and version.change_description are required. Don’t send id or version.num.
Authentication
JWT bearer token authentication. Include the Configuration API key in the Authorization header as ‘Bearer <token>’.
Request
Who can use the assistant. Exactly one of allow_all, allowed_emails or allowlist_rule_dsl; required on create. The creator always retains access.
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.
Response
The created productivity assistant. plugin_identifiers includes enterprise_search_plugin when the knowledge scope isn’t empty.
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.