Skip to content
/
Retrieve assistant
Last updated

Retrieve assistant

🔨 In Development — This section is still being developed and may change.
Get detailed information for a specific assistant by ID.
GEThttps://api.freddy.aitronos.com/v1/assistants/{assistant_id}

Path Parameters

assistant_id string required

The unique identifier of the assistant to retrieve.

Returns

An Assistant object with complete configuration details.

Bash
curl "https://api.freddy.aitronos.com/v1/assistants/asst_abc123" \
  -H "Authorization: Bearer $FREDDY_API_KEY"

Response

Returns a complete Assistant object. See the Assistant object documentation for all available fields and their descriptions.

{
  "id": "asst_abc123",
  "organization_id": "org_abc123",
  "created_by": "uid_user123",
  "created_at": 1705315800,
  "updated_at": 1705761900,
  "deleted_at": null,
  "name": "Customer Support Bot",
  "avatar_id": "avt_support_green",
  "default_model_key": "gpt-4o",
  "allowed_model_providers": ["openai", "anthropic"],
  "instructions": "You are a helpful customer support assistant...",
  "tool_configurations": {
    "systemTools": {
      "webSearch": {
        "mode": "auto",
        "sources": true
      },
      "fileSearch": {
        "mode": "on",
        "results": true
      },
      "codeInterpreter": {
        "mode": "off"
      }
    },
    "mcpTools": [],
    "streamlineTools": []
  },
  "system_message": null,
  "context_strategy": "auto",
  "max_output_synapses": 4096,
  "max_tool_calls": 10,
  "parallel_tool_calls": true,
  "reasoning": null,
  "service_tier": "default",
  "store": true,
  "temperature": 0.7,
  "text_configuration": {},
  "top_logprobs": 0,
  "top_p": 1.0,
  "truncation": "disabled",
  "access_mode": "organization",
  "access_departments": [],
  "access_users": [],
  "editable_by_users": [],
  "visible_in_chat_to_users": [],
  "editable_by_roles": ["admin", "manager"],
  "visible_to_roles": ["member", "admin"],
  "vector_store_ids": ["vs_abc123"],
  "api_enabled": true,
  "is_active": true,
  "metadata": {
    "department": "customer_success"
  },
  "rulesAttached": []
}

Errors

404 Not Found
{
  "error": {
    "code": "assistant_not_found",
    "message": "Assistant with ID 'asst_abc123' not found",
    "trace_id": "trace_abc123"
  }
}
Previous page
Next page