Skip to content
/
Update assistant
Last updated

Update assistant

🔨 In Development — This section is still being developed and may change.
Update an existing assistant's configuration, tools, and settings.
PUThttps://api.freddy.aitronos.com/v1/assistants/{assistant_id}

Path Parameters

assistant_id string required

The unique identifier of the assistant to update.

Request Body

name string optional

The name of the assistant. Must be unique within the organization.

description string optional

A brief description of the assistant's purpose and capabilities.

model string optional

The AI model to use for this assistant. View available models →

instructions string optional

System instructions that define the assistant's behavior and personality.

avatar_id string optional

Predefined avatar identifier from the Aitronos avatar library. View available avatars →

avatar string optional

Custom avatar URL. Used when you want to provide your own avatar image instead of using a predefined one.

toolConfigurations object optional

Configuration for built-in system tools and external integrations. See Assistant object for full structure.

systemMessage array optional

Pre-configured system messages or input examples. An array of input message objects with texts, images, or files.

contextStrategy string optional · Defaults to auto

Sets the overall thread context management strategy. Values: full, off, auto, saver.

maxToolCalls integer optional

Maximum number of built-in tool calls allowed per response.

parallelToolCalls boolean optional

Whether the assistant can execute multiple tool calls simultaneously.

accessMode string optional

Access control for the assistant. One of private, restricted, department, organization, global, public.

temperature number optional

Controls randomness in responses (0.0 to 2.0).

maxOutputSynapses integer optional

Maximum output length in synapses.

isActive boolean optional

Whether the assistant is active and available for use.

apiEnabled boolean optional

Whether the assistant is accessible via API.

Bash
curl https://api.freddy.aitronos.com/v1/assistants/asst_abc123 \
  -X PUT \
  -H "Authorization: Bearer $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Assistant Name"
  }'

Response

Returns

The updated Assistant object with all configuration details.

{
  "id": "asst_abc123",
  "name": "Updated Assistant Name",
  "description": "AI assistant for research and analysis",
  "model": "gpt-4o",
  "instructions": "You are a research assistant that helps find and analyze information.",
  "tools": [
    {
      "type": "web_search",
      "search_context_size": "large"
    },
    {
      "type": "code_interpreter"
    },
    {
      "type": "function",
      "name": "get_weather",
      "description": "Get current weather",
      "parameters": {
        "type": "object",
        "properties": {
          "location": {"type": "string"}
        }
      }
    }
  ],
  "access_mode": "private",
  "is_active": true,
  "temperature": 0.3,
  "max_output_synapses": 4000,
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-20T14:45:00Z",
  "organization_id": "org_abc123",
  "created_by": "user_abc123"
}
Previous page
Next page