Agents

Create a new agent

Create a new AI agent with specified configuration including system prompt, tools, and model settings

post/api/agents

Request

namestring required

Name of the agent

descriptionstring required

Description of what the agent does

systemPromptstring required

System prompt that defines the agent behavior and instructions

toolNamesstring[] required

Array of tool names that this agent can use

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

How this agent resolves tools at runtime

cliNamesstring[]

Optional array of CLI integration ids that this agent can use

modelAliasunknown required

Optional reasoning level, from the levels the model offers; omit for the model default. Applies with token-based pricing.

fastModeboolean

Run the model in its fast mode, at its fast-mode price. Only models with a fast mode accept it. Applies with token-based pricing.

tinesStoryImportIdstring uuid nullable

Optional reference to the Tines story import template used to create this agent

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

Optional planning behavior; defaults to auto

persistentWorkspaceEnabledboolean

Optional persistent workspace setting; defaults to enabled for new agents

tagsstring[]

Array of tags for categorizing the agent

acceptanceCriteriastring[]

Optional list of acceptance criteria evaluated for every run

Successful response

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