# Hodoflow GraphQL API — schema version 2026-07-05
# Generated from DashWeb.Api.GraphqlSchema — do not edit by hand (mix dash.api.docs).

schema {
  query: RootQueryType
}

"A page of :fact"
type PageOfFact {
  "Whether or not there is a next page"
  hasNextPage: Boolean!

  "Whether or not there is a previous page"
  hasPreviousPage: Boolean!

  "The number of the current page"
  pageNumber: Int!

  "The number of the last page"
  lastPage: Int!

  "The number of records per page"
  limit: Int!

  "Total count on all pages"
  count: Int

  "The records contained in the page"
  results: [Fact!]
}

type Fact {
  id: ID!

  "The DataModel blueprint this fact conforms to"
  dataModelId: ID!

  "Business entity identifier extracted from the DataModel's primary key field. Scoped by data_model_id."
  entityId: String

  "When the underlying business event occurred (mappable by users via DataMapping)"
  observedAt: DateTime!

  "The harmonized business data matching DataModel field definitions"
  data: Json!

  insertedAt: DateTime!
}

type RootQueryType {
  "Liveness probe. Not backed by an Ash action; always returns \"ok\"."
  health: String

  "Query harmonized facts for a DataModel (by slug) as a logical table."
  factQuery(
    "Rows per page. Defaults to 50 and rejects values above 250."
    limit: Int

    "Number of matching rows to skip. Defaults to 0."
    offset: Int

    "Required data-model slug resolved inside the service account's workspace."
    dataModelSlug: String!

    "Query mode: latest or timeline. Defaults to latest, which returns one current row per entity."
    mode: String

    "Time-window axis: observed_at or inserted_at. Defaults to observed_at."
    timeAxis: String

    "Inclusive lower time bound. Timeline mode defaults to 90 days before until."
    since: DateTime

    "Upper time bound. Timeline mode defaults to now and clamps spans to 366 days."
    until: DateTime

    "JSON array of at most 20 {field, op, value} clauses. Fields must belong to the selected data model."
    filters: String

    "Timeline sort field: observed_at, inserted_at, or entity_id. Defaults to observed_at."
    sort: String

    "Sort direction: asc or desc. Defaults to desc."
    sortDirection: String
  ): PageOfFact
}

"""
The `Json` scalar type represents arbitrary json string data, represented as UTF-8
character sequences. The Json type is most often used to represent a free-form
human-readable json string.
"""
scalar Json

"""
The `DateTime` scalar type represents a date and time in the UTC
timezone. The DateTime appears in a JSON response as an ISO8601 formatted
string, including UTC timezone ("Z"). The parsed date and time string will
be converted to UTC if there is an offset.
"""
scalar DateTime