← API reference
CANONICAL TYPE REFERENCE

TaskState

A task requiring human action

Unique identifier

Task type (manual or approval)

Current status

titleString!

Task title

Optional description

Associated task definition (for manual tasks)

Linked resource type (e.g., job, component)

Linked resource ID

Directly assigned user

Assigned team

User who claimed this team task

User who created this task

Priority (higher = more urgent)

Due date (ISO8601)

outcomeString

Selected outcome value

Additional outcome data (JSON)

Workflow execution (for approval tasks)

Workflow node ID (for approval tasks)

Completion timestamp (ISO8601)

createdAtString!

Creation timestamp (ISO8601)

updatedAtString!

Last update timestamp (ISO8601)

View exact SDL
"""A task requiring human action"""
type TaskState {
  """Unique identifier"""
  id: TaskID!
  """Task type (manual or approval)"""
  type: TaskType!
  """Current status"""
  status: TaskStatus!
  """Task title"""
  title: String!
  """Optional description"""
  description: String
  """Associated task definition (for manual tasks)"""
  taskDefinitionId: TaskDefinitionID
  """Linked resource type (e.g., job, component)"""
  resourceType: String
  """Linked resource ID"""
  resourceId: String
  """Directly assigned user"""
  assignedUserId: UserID
  """Assigned team"""
  assignedTeamId: TeamID
  """User who claimed this team task"""
  claimedByUserId: UserID
  """User who created this task"""
  createdByUserId: UserID!
  """Priority (higher = more urgent)"""
  priority: Int!
  """Due date (ISO8601)"""
  dueAt: ISO8601
  """Selected outcome value"""
  outcome: String
  """Additional outcome data (JSON)"""
  outcomeData: String
  """Workflow execution (for approval tasks)"""
  workflowExecutionId: WorkflowExecutionID
  """Workflow node ID (for approval tasks)"""
  workflowNodeId: String
  """Completion timestamp (ISO8601)"""
  completedAt: ISO8601
  """Creation timestamp (ISO8601)"""
  createdAt: String!
  """Last update timestamp (ISO8601)"""
  updatedAt: String!
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.