Skip to content
/
Get history
Last updated

Get assistant history

🔨 In Development — This section is still being developed and may change.
Retrieve the complete change history for a specific assistant. This is a convenience endpoint that filters audit logs for the specified assistant.
GEThttps://api.freddy.aitronos.com/v1/assistants/{assistant_id}/history

Get all audit log entries for a specific assistant, showing who made changes, when, and what was modified.

Path Parameters

assistant_id string required

The unique identifier of the assistant.

Query Parameters

action string optional

Filter by action type. Values: created, updated, deleted.

user_id string optional

Filter by user who performed the action.

start_date string optional

Filter logs from this date (ISO 8601 format).

end_date string optional

Filter logs until this date (ISO 8601 format).

limit integer optional · Defaults to 50

Number of logs to return per page. Maximum: 100.

offset integer optional · Defaults to 0

Number of logs to skip for pagination.

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

Response

Returns an array of Audit Log objects for the specified assistant.

{
  "audit_logs": [
    {
      "id": "log_abc123",
      "timestamp": "2025-01-20T10:30:00Z",
      "resource_type": "assistant",
      "resource_id": "asst_abc123",
      "resource_name": "Customer Support Bot",
      "action": "updated",
      "user_id": "uid_user123",
      "user_name": "John Doe",
      "user_email": "john@example.com",
      "changes": [
        {
          "field": "temperature",
          "old_value": 0.7,
          "new_value": 0.9
        },
        {
          "field": "tools.web_search",
          "old_value": false,
          "new_value": true
        }
      ],
      "metadata": {
        "ip_address": "192.168.1.1",
        "user_agent": "Mozilla/5.0...",
        "source": "web_ui"
      }
    },
    {
      "id": "log_def456",
      "timestamp": "2025-01-15T14:22:00Z",
      "resource_type": "assistant",
      "resource_id": "asst_abc123",
      "resource_name": "Customer Support Bot",
      "action": "created",
      "user_id": "uid_user123",
      "user_name": "John Doe",
      "user_email": "john@example.com",
      "changes": [],
      "metadata": {
        "ip_address": "192.168.1.1",
        "user_agent": "Mozilla/5.0...",
        "source": "web_ui"
      }
    }
  ],
  "pagination": {
    "total": 2,
    "limit": 50,
    "offset": 0,
    "has_more": false
  }
}

Errors

404 Not Found
{
  "error": {
    "message": "Assistant not found",
    "type": "not_found_error",
    "code": "assistant_not_found"
  }
}
Previous page
Next page