← API reference
Mutation / jobs

updateTask

Edit task metadata without changing its lifecycle. Requires task:write permission.

Arguments

Existing task whose editable metadata should change.

Metadata edits with omission preserving current values and null clearing supported optional fields.

Returns TaskPayload!

Explore in a view

Production Floor
View exact SDL
"""
Edit task metadata without changing its lifecycle. Requires task:write permission.
"""
updateTask(
  """Existing task whose editable metadata should change."""
  id: TaskID!
  """
  Metadata edits with omission preserving current values and null clearing supported optional fields.
  """
  input: UpdateTaskInput!
): TaskPayload! @topic(names: ["jobs"])

Schema reference describes the API contract. Actual access is checked by the platform for every operation.