# Connection timeline

View the event history for a connection.

Returns a chronological list of events (syncs, schema changes, errors) for a connection.

#### Path Parameters

**`connection_id`** string required

The connection ID.

#### Query Parameters

**`event_type`** string optional

Filter by event type.

**`status`** string optional

Filter by event status.

**`limit`** integer optional

Maximum number of results.

**`offset`** integer optional

Pagination offset.

## Returns

A timeline object containing a `data` array of event objects with `event_id`, `event_type`, `created_at`, and `summary`.

Request

```bash cURL
curl "https://api.aitronos.com/v1/organizations/org_xyz789/knowledge/connectors/connections/conn_abc123/timeline?limit=20" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```


```python Python SDK
from aitronos import Aitronos

client = Aitronos(api_key="your-api-key")

timeline = client.knowledge_connectors.get_timeline(
    organization_id="org_xyz789",
    connection_id="conn_abc123",
    limit=20,
)
print(timeline)
```


```python Python
import requests

org_id = "org_xyz789"
conn_id = "conn_abc123"
url = f"https://api.aitronos.com/v1/organizations/{org_id}/knowledge/connectors/connections/{conn_id}/timeline"
headers = {"Authorization": "Bearer YOUR_ACCESS_TOKEN"}

response = requests.get(url, headers=headers, params={"limit": 20})
print(response.json())
```


```javascript JavaScript
const response = await fetch(
  "https://api.aitronos.com/v1/organizations/org_xyz789/knowledge/connectors/connections/conn_abc123/timeline?limit=20",
  {
    headers: { Authorization: "Bearer YOUR_ACCESS_TOKEN" },
  }
);
const data = await response.json();
console.log(data);
```

Response

```json 200 OK
{
  "data": [
    {
      "event_id": "evt_abc123",
      "event_type": "sync_completed",
      "created_at": "2024-06-15T10:02:30Z",
      "summary": {
        "rows_synced": 5000,
        "bytes_synced": 1048576,
        "duration": "PT2M30S"
      }
    },
    {
      "event_id": "evt_def456",
      "event_type": "schema_change_detected",
      "created_at": "2024-06-14T08:00:00Z",
      "summary": {
        "stream": "users",
        "change": "field_added"
      }
    }
  ]
}
```


```json 4xx Error
{
  "success": false,
  "error": {
    "code": "CONNECTOR_CONNECTION_NOT_FOUND",
    "message": "The requested connection was not found.",
    "type": "client_error",
    "status": 404,
    "details": {},
    "trace_id": "abc-123-def",
    "timestamp": "2025-12-22T15:30:00Z"
  }
}
```

## Related Resources

- [Manage Connections](/docs/api-reference/knowledge-connectors/connections)
- [Manage Jobs](/docs/api-reference/knowledge-connectors/jobs)