Skip to main content

TaskQueries

No description

type TaskQueries {
  getTask(
    taskId: Long
    publicId: String
  ): WorkflowTask
  getTasksByIds(
    ids: [Long!]!
  ): [WorkflowTask!]
  getTasksByPublicIds(
    publicIds: [String!]!
  ): [WorkflowTask!]
  listTasks(
    startDate: LocalDate
    endDate: LocalDate
    includeCompleted: Boolean
    assignedTo: [Long!]
    priorities: [String!]
    relatedProcess: Long
    relatedTeam: Long
    relatedTeams: [Long!]
    completedFrom: LocalDate
    completedTo: LocalDate
    searchQuery: String
    manualOnly: Boolean
    dueFromAt: ZonedDateTime
    dueToAt: ZonedDateTime
    completedFromAt: ZonedDateTime
    completedToAt: ZonedDateTime
  ): [WorkflowTask!]
  listOverdueTasks: [WorkflowTask!]
  taskTimeSeries(
    granularity: String!
    mode: String!
    from: LocalDate!
    to: LocalDate!
    assignedTo: [Long!]
    relatedTeams: [Long!]
    relatedProcesses: [Long!]
    priorities: [String!]
    timezone: String
  ): [TaskSeriesPoint!]
  taskUpdates(
    taskId: Long!
    before: Long
    limit: Int
  ): TaskUpdatesPage
  taskAgentSession(
    taskId: Long!
  ): AgentTaskSessionView
}

Fields

`TaskQueries.getTask` ● `WorkflowTask` object

Get a specific task by ID

`TaskQueries.getTask.taskId` ● `Long` scalar

`TaskQueries.getTask.publicId` ● `String` scalar

`TaskQueries.getTasksByIds` ● `[WorkflowTask!]` list object

Get several tasks by ID at once (org-scoped; unknown/foreign ids are dropped)

`TaskQueries.getTasksByIds.ids` ● `[Long!]!` non-null scalar

`TaskQueries.getTasksByPublicIds` ● `[WorkflowTask!]` list object

Get several tasks by public id (UUID) at once (org-scoped; unknown/foreign ids are dropped)

`TaskQueries.getTasksByPublicIds.publicIds` ● `[String!]!` non-null scalar

`TaskQueries.listTasks` ● `[WorkflowTask!]` list object

List tasks for the current organization

`TaskQueries.listTasks.startDate` ● `LocalDate` scalar

`TaskQueries.listTasks.endDate` ● `LocalDate` scalar

`TaskQueries.listTasks.includeCompleted` ● `Boolean` scalar

`TaskQueries.listTasks.assignedTo` ● `[Long!]` list scalar

`TaskQueries.listTasks.priorities` ● `[String!]` list scalar

`TaskQueries.listTasks.completedFrom` ● `LocalDate` scalar

`TaskQueries.listTasks.completedTo` ● `LocalDate` scalar

`TaskQueries.listTasks.searchQuery` ● `String` scalar

`TaskQueries.listTasks.manualOnly` ● `Boolean` scalar

Only manual tasks (no related workflow/process)

`TaskQueries.listTasks.dueFromAt` ● `ZonedDateTime` scalar

Optional lower bound on the task's due time. Tasks with no due time (date-only) are never excluded by it.

`TaskQueries.listTasks.dueToAt` ● `ZonedDateTime` scalar

Optional upper bound on the task's due time. Tasks with no due time (date-only) are never excluded by it.

`TaskQueries.listTasks.completedFromAt` ● `ZonedDateTime` scalar

Optional lower bound on the task's completion time. Tasks with no completion time are never excluded by it.

`TaskQueries.listTasks.completedToAt` ● `ZonedDateTime` scalar

Optional upper bound on the task's completion time. Tasks with no completion time are never excluded by it.

`TaskQueries.listOverdueTasks` ● `[WorkflowTask!]` list object

List overdue tasks for the current organization

`TaskQueries.taskTimeSeries` ● `[TaskSeriesPoint!]` list object

Task-throughput series bucketed by time and split by process

`TaskQueries.taskTimeSeries.granularity` ● `String!` non-null scalar

Bucket size: hour, day, week, or month

`TaskQueries.taskTimeSeries.mode` ● `String!` non-null scalar

completed (by completion time) or pending (by due date)

`TaskQueries.taskTimeSeries.from` ● `LocalDate!` non-null scalar

Inclusive start of the range (by completion/due date)

`TaskQueries.taskTimeSeries.to` ● `LocalDate!` non-null scalar

Inclusive end of the range (by completion/due date)

`TaskQueries.taskTimeSeries.assignedTo` ● `[Long!]` list scalar

`TaskQueries.taskTimeSeries.priorities` ● `[String!]` list scalar

`TaskQueries.taskTimeSeries.timezone` ● `String` scalar

IANA zone the Hour buckets are computed in (e.g. America/Mexico_City). Defaults to UTC — never the server JVM default.

`TaskQueries.taskUpdates` ● `TaskUpdatesPage` object

One newest-first page of the task's audit trail (who changed which field, old -> new), with resolved actor display info

`TaskQueries.taskUpdates.taskId` ● `Long!` non-null scalar

`TaskQueries.taskUpdates.before` ● `Long` scalar

Pagination cursor: return audit rows with taskUpdateId strictly below this (newest page when omitted).

`TaskQueries.taskUpdates.limit` ● `Int` scalar

Page size; server-clamped to 1-100 (default 50).

`TaskQueries.taskAgentSession` ● `AgentTaskSessionView` object

The agent session working this task, with its timeline and the runs behind it. Null when no agent has ever worked the task.

`TaskQueries.taskAgentSession.taskId` ● `Long!` non-null scalar

Returned By

Fields
Returned By