# Retrieve assistant

div
strong
🔨 In Development
 — This section is still being developed and may change.


Get detailed information for a specific assistant by ID.

#### Path Parameters

**`assistant_id`** string required

The unique identifier of the assistant to retrieve.

## Returns

An [Assistant object](/docs/api-reference/objects/assistant-object) with complete configuration details.


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


```python
import requests

response = requests.get(
    "https://api.freddy.aitronos.com/v1/assistants/asst_abc123",
    headers={"Authorization": f"Bearer {api_key}"}
)

assistant = response.json()
print(f"Assistant: {assistant['name']}")
```


```javascript
const response = await fetch('https://api.freddy.aitronos.com/v1/assistants/asst_abc123', {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});

const assistant = await response.json();
console.log(`Assistant: ${assistant.name}`);
```

## Response

Returns a complete [Assistant object](/docs/api-reference/objects/assistant-object). See the Assistant object documentation for all available fields and their descriptions.


```json
{
  "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


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


```json 401 Unauthorized
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing authentication token",
    "trace_id": "trace_abc123"
  }
}
```


```json 403 Forbidden
{
  "error": {
    "code": "access_denied",
    "message": "You do not have permission to access this assistant",
    "trace_id": "trace_abc123"
  }
}
```