← API reference
CANONICAL TYPE REFERENCE

UpsertMilestoneInput

Input for creating or updating a milestone

ID for update; omit for create

Parent job ID (required)

Component to scope this milestone to. Must belong to jobId. Omit for a job-wide milestone.

External system identifier

External id of the record marking the start (must be unique per tenant)

External id of the record marking the completion (must be unique per tenant)

nameString!

Milestone name (required)

Milestone description

Date the milestone is due to start (ISO8601)

Due date (ISO8601)

Pre-set start timestamp (ISO8601). Sticky: omit to preserve existing — clear via unstartMilestone.

Pre-set completion timestamp (ISO8601). For load-with-complete-data imports. Sticky: omit to preserve existing — clear via uncompleteMilestone.

Pre-set cancellation timestamp (ISO8601). Sticky: omit to preserve existing — clear via uncancelMilestone.

Pre-set cancellation reason. Sticky: omit to preserve existing.

Sort order (defaults to 0)

View exact SDL
"""Input for creating or updating a milestone"""
input UpsertMilestoneInput {
  """ID for update; omit for create"""
  id: MilestoneID
  """Parent job ID (required)"""
  jobId: JobID!
  """
  Component to scope this milestone to. Must belong to jobId. Omit for a job-wide milestone.
  """
  componentId: ComponentID
  """External system identifier"""
  externalId: String
  """
  External id of the record marking the start (must be unique per tenant)
  """
  externalStartId: String
  """
  External id of the record marking the completion (must be unique per tenant)
  """
  externalCompletionId: String
  """Milestone name (required)"""
  name: String!
  """Milestone description"""
  description: String
  """Date the milestone is due to start (ISO8601)"""
  startDueAt: ISO8601
  """Due date (ISO8601)"""
  dueAt: ISO8601
  """
  Pre-set start timestamp (ISO8601). Sticky: omit to preserve existing — clear via unstartMilestone.
  """
  startedAt: ISO8601
  """
  Pre-set completion timestamp (ISO8601). For load-with-complete-data imports. Sticky: omit to preserve existing — clear via uncompleteMilestone.
  """
  completedAt: ISO8601
  """
  Pre-set cancellation timestamp (ISO8601). Sticky: omit to preserve existing — clear via uncancelMilestone.
  """
  cancelledAt: ISO8601
  """Pre-set cancellation reason. Sticky: omit to preserve existing."""
  cancelReason: String
  """Sort order (defaults to 0)"""
  sortOrder: Int
}

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