COcotool
Agents

Update agent

Modify an agent's configuration, such as tools, prompts, or model settings.

put/api/agents/{agentId}

Request

  • Base URL
    https://app.cotool.ai
  • Auth
    HTTP bearer

Path parameters

agentIdstring uuid required

Unique identifier of the agent to update

Request body

namestring

Optional new name for the agent

descriptionstring

Optional new description for the agent

versionDescriptionstring

Optional description for the agent version created by this update

systemPromptstring

Optional new system prompt for the agent

toolNamesstring[]

Optional new array of tool names for the agent

toolSelectionMode'manual' | 'all_read_only' | 'all_read_only_plus_selected'

Optional new tool selection mode for the agent

cliNamesstring[]

Optional new array of CLI integration ids for the agent

modelAliasunknown
reasoningEffort'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'null' nullable

Optional new reasoning level, from the levels the model offers; null restores the model default. When only the model changes, a level the new model does not offer is cleared. Applies with token-based pricing.

fastModeboolean

Optionally turn fast mode on or off. Only models with a fast mode accept true; changing to a model without one turns it off. Applies with token-based pricing.

tinesStoryImportIdstring uuid nullable

Optional reference to the Tines story import template (can be set to null to clear)

planningMode'never' | 'always' | 'auto'

Optional new planning behavior for this agent

persistentWorkspaceEnabledboolean

Optional persistent workspace setting for this agent

slackReplyScope'anyone' | 'cotool_users' | 'null' nullable

Optional default Slack reply scope for chats not started by a Slack trigger (anyone | cotool_users)

tagsstring[]

Array of tags for categorizing the agent

acceptanceCriteriastring[]

Optional list of acceptance criteria evaluated for every run

Response

Successful response

OR

Changes

No recorded changes to this operation across all 2 revisions of this API.