List integration flow activity history

get

https://one.fracttal.com/hub/api/v1/dags/{dag_id}/timeline/

With this endpoint you can view the activity of a DAG's runs grouped by time interval: hour, day, week, or month. Useful for identifying load patterns and detecting periods with more failures.

Authentication

Requires a Bearer OAuth2 token obtained via the client_credentials flow. See Authentication.

Path parameters

Parameter	Type	Required	Description
`dag_id`	string (UUID)	✅	UUID of the DAG/ETL in `8-4-4-4-12` format

Query parameters

Parameter	Type	Required	Default	Description
`start_date`	string (YYYY-MM-DD)	✅	—	Start of the date range
`end_date`	string (YYYY-MM-DD)	✅	—	End of the date range
`interval`	string	—	`day`	Grouping: `hour`, `day`, `week`, or `month`

Headers

Name	Value
`Authorization`	`Bearer <access_token>`
`Accept`	`application/json`

Request example

GET /hub/api/v1/dags/589b6c65-1ce9-4a46-9c11-ad380d9bf27a/timeline?start_date=2026-06-01&end_date=2026-06-05&interval=day
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...
Accept: application/json

Successful response — 200

{
  "interval": "day",
  "points": [
    { "timestamp": "2026-06-03", "total_runs": 5, "successful": 5, "failed": 0 },
    { "timestamp": "2026-06-04", "total_runs": 8, "successful": 7, "failed": 1 },
    { "timestamp": "2026-06-05", "total_runs": 6, "successful": 6, "failed": 0 }
  ]
}

Field	Type	Description
`interval`	string	The grouping interval applied
`points`	array	Timeline data points
`points[].timestamp`	string	Start of the bucket (format depends on `interval`)
`points[].total_runs`	integer	Total runs in the bucket
`points[].successful`	integer	Fully successful runs
`points[].failed`	integer	Runs with at least one failed phase

Error codes

Code	Description
`401`	Invalid or expired token
`422`	Invalid date range or interval — check `details[]`
`502`	Error querying the timeline

Possible issues

All errors follow the RFC 9457 format with Content-Type: application/problem+json.

`401` — Missing, invalid, or expired token

See Authentication issues.

`422` — Invalid parameter

{
  "error_code": "VALIDATION_ERROR",
  "message": "Invalid request parameters",
  "status_code": 422,
  "details": [
    { "field": "interval", "message": "interval must be one of: hour, day, week, month" }
  ]
}

Common causes: dates in the wrong format, start_date after end_date, or an interval value outside the allowed enum.

`502` — Error in a dependent service

{
  "error_code": "BACKEND_RPC_ERROR",
  "message": "Upstream service returned an unexpected error",
  "status_code": 502
}

Solution: Retry with exponential backoff.

OpenAPI definition

{
  "openapi": "3.0.0",
  "info": {
    "version": "1.0.0",
    "title": "Timeline of a DAG's runs"
  },
  "servers": [
    {
      "url": " https://one.fracttal.com/hub/api/v1/dags/{dag_id}/timeline"
    }
  ],
  "paths": {
    "/": {
      "get": {
        "responses": {
          "200": {
            "description": ""
          }
        },
        "parameters": [],
        "summary": "List integration flow activity history",
        "operationId": "get_",
        "description": "With this endpoint you can view the activity of a DAG's runs grouped by time interval: hour, day, week, or month. Useful for identifying load patterns and detecting periods with more failures."
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}

Response

200

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here!