Updates an existing custom AI agent in Box AI Studio. You can modify the agent's name, access settings, icon, and capability configurations (ask, text_gen, extract). **Requirements:** - Box Enterprise Advanced account with Box AI Studio enabled - "Manage AI" scope must be enable…
nameRequiredstringThe display name of the AI Agent. This name will be visible to users in the Box interface.
typestringThe type of agent. Must be 'ai_agent' for all AI agents.
agent_idRequiredstringThe unique identifier of the AI Agent to update. This is a numeric string ID returned when creating an agent or listing agents.
ask__typestringType for the 'ask' capability. Must be 'ai_agent_ask' when configuring this capability.
access_stateRequiredstringControls who can access the AI Agent. Values: 'enabled' (all users), 'disabled' (no users), 'enabled_for_selected_users' (only users/groups in allowed_entities).
extract__typestringType for the 'extract' capability. Must be 'ai_agent_extract' when configuring this capability.
icon_referencestringURL to the agent's avatar icon. Must use format: https://cdn01.boxcdn.net/app-assets/aistudio/avatars/<file_name> Valid file names (supports both .png and .svg): logo_boxAi, logo_stamp, logo_legal, logo_finance, logo_config, logo_handshake, logo_analytics, logo_classification. E…
text__gen__typestringType for the 'text_gen' capability. Must be 'ai_agent_text_gen' when configuring this capability.
allowed_entitiesarrayList of users or groups allowed to access the agent (only used when access_state is 'enabled_for_selected_users'). Each entity should have 'type' ('user' or 'group') and 'id' fields.
ask__descriptionstringDescription of the agent's 'ask' capability shown to users. Explains what questions the agent can answer.
ask__access__statestringWhether the 'ask' capability is active. Values: 'enabled' or 'disabled'.
extract__descriptionstringDescription of the agent's metadata extraction capability shown to users. Explains what data the agent can extract from documents.
dataRequiredData from the action execution
errorstringError if any occurred during the execution of the action
successfulRequiredbooleanWhether or not the action execution was successful or not
OAuth connection. Risk level 2 of 5.
Free Action
No published Skills explicitly reference this Action yet.