TaskMutations

No description

type TaskMutations {
  createTask(
    task: WorkflowTaskInput!
  ): WorkflowTask
  createTaskWithAssignment(
    name: String!
    dueDate: LocalDate!
    priority: String!
    userId: Long
    teamId: Long
    relatedWorkflow: Long
    description: String
    metadata: String
    embeddedPages: [EmbeddedPageInput!]
    teamAssigneeMethod: String
  ): WorkflowTask
  updateTaskStatus(
    taskId: Long!
    completed: Boolean!
  ): WorkflowTask
  updateTaskAssignee(
    taskId: Long!
    assignedTo: Long!
  ): WorkflowTask
  updateTaskDueDate(
    taskId: Long!
    dueDate: LocalDate!
  ): WorkflowTask
  updateTaskPriority(
    taskId: Long!
    priority: String!
  ): WorkflowTask
  updateTaskNotes(
    taskId: Long!
    notes: String
  ): WorkflowTask
  updateTaskMetadata(
    taskId: Long!
    metadata: String
  ): WorkflowTask
  updateTaskEmbeddedPages(
    taskId: Long!
    pages: [EmbeddedPageInput!]!
  ): WorkflowTask
  updateTaskTeam(
    taskId: Long!
    teamId: Long
  ): WorkflowTask
  stopTaskAgent(
    taskId: Long!
  ): WorkflowTask
  takeOverTaskAgent(
    taskId: Long!
  ): WorkflowTask
  startTaskAgent(
    taskId: Long!
  ): WorkflowTask
  answerAgentRequest(
    agentSessionRequestId: Long!
    approved: Boolean
    text: String
    editedArguments: String
    formData: String
    allowUploadSite: Boolean
  ): AgentSessionRequest
  decideAgentPlan(
    taskId: Long!
    approved: Boolean!
    message: String
  ): WorkflowTask
  rateAgentTask(
    agentSessionId: Long!
    rating: String!
    comment: String
  ): AgentTaskSessionView
  submitTaskForm(
    taskId: Long!
    formData: String!
  ): WorkflowTask
  requestFormUploadUrl(
    taskId: Long!
    fieldName: String!
    fileName: String!
    contentType: String!
    declaredSize: Long!
  ): FormUploadTicket
  resolveFormDownloadUrl(
    objectKey: String!
  ): String
  deleteTask(
    taskId: Long!
  ): Boolean
  batchUpdateTasks(
    taskIds: [Long!]!
    completed: Boolean
    priority: String
    assignedTo: Long
    dueDate: LocalDate
    changeTeam: Boolean!
    teamId: Long
    assignment: TaskAssignmentInput
  ): [WorkflowTask!]
  batchAppendTaskNotes(
    taskIds: [Long!]!
    text: String!
  ): [WorkflowTask!]
  batchDeleteTasks(
    taskIds: [Long!]!
  ): Int
}

Fields

TaskMutations.createTask ● WorkflowTask object

Create a new task

TaskMutations.createTask.task ● WorkflowTaskInput! non-null input

TaskMutations.createTaskWithAssignment ● WorkflowTask object

Create a new task with user or team-based assignment. Provide userId for direct assignment or teamId for random team member assignment.

TaskMutations.createTaskWithAssignment.name ● String! non-null scalar

TaskMutations.createTaskWithAssignment.dueDate ● LocalDate! non-null scalar

TaskMutations.createTaskWithAssignment.priority ● String! non-null scalar

TaskMutations.createTaskWithAssignment.userId ● Long scalar

TaskMutations.createTaskWithAssignment.teamId ● Long scalar

TaskMutations.createTaskWithAssignment.relatedWorkflow ● Long scalar

TaskMutations.createTaskWithAssignment.description ● String scalar

TaskMutations.createTaskWithAssignment.metadata ● String scalar

TaskMutations.createTaskWithAssignment.embeddedPages ● [EmbeddedPageInput!] list input

TaskMutations.createTaskWithAssignment.teamAssigneeMethod ● String scalar

TaskMutations.updateTaskStatus ● WorkflowTask object

Mark task as completed or incomplete

TaskMutations.updateTaskStatus.taskId ● Long! non-null scalar

TaskMutations.updateTaskStatus.completed ● Boolean! non-null scalar

TaskMutations.updateTaskAssignee ● WorkflowTask object

Reassign task to another user

TaskMutations.updateTaskAssignee.taskId ● Long! non-null scalar

TaskMutations.updateTaskAssignee.assignedTo ● Long! non-null scalar

TaskMutations.updateTaskDueDate ● WorkflowTask object

Update task due date

TaskMutations.updateTaskDueDate.taskId ● Long! non-null scalar

TaskMutations.updateTaskDueDate.dueDate ● LocalDate! non-null scalar

TaskMutations.updateTaskPriority ● WorkflowTask object

Update task priority

TaskMutations.updateTaskPriority.taskId ● Long! non-null scalar

TaskMutations.updateTaskPriority.priority ● String! non-null scalar

TaskMutations.updateTaskNotes ● WorkflowTask object

Update task notes

TaskMutations.updateTaskNotes.taskId ● Long! non-null scalar

TaskMutations.updateTaskNotes.notes ● String scalar

TaskMutations.updateTaskMetadata ● WorkflowTask object

Replace the task's metadata JSON. Any valid JSON value is accepted; omit or send blank to clear (max 64 KB).

TaskMutations.updateTaskMetadata.taskId ● Long! non-null scalar

TaskMutations.updateTaskMetadata.metadata ● String scalar

TaskMutations.updateTaskEmbeddedPages ● WorkflowTask object

Replace a task's embedded pages (the list overwrites the stored one; empty clears)

TaskMutations.updateTaskEmbeddedPages.taskId ● Long! non-null scalar

TaskMutations.updateTaskEmbeddedPages.pages ● [EmbeddedPageInput!]! non-null input

TaskMutations.updateTaskTeam ● WorkflowTask object

Update task team

TaskMutations.updateTaskTeam.taskId ● Long! non-null scalar

TaskMutations.updateTaskTeam.teamId ● Long scalar

TaskMutations.stopTaskAgent ● WorkflowTask object

Take the agent off a task, closing its session. The task keeps its human owner and its history.

TaskMutations.stopTaskAgent.taskId ● Long! non-null scalar

TaskMutations.takeOverTaskAgent ● WorkflowTask object

Take a task back from an agent that is waiting on someone (a question, an approval, a timer, an update or a report to read): the session ends as Stopped with your name as the reason, its pending request is cancelled, and the agent stays on the task so it can be started again. The task's owner, their team or an agent administrator. Fails while the agent is working: stop it instead.

TaskMutations.takeOverTaskAgent.taskId ● Long! non-null scalar

TaskMutations.startTaskAgent ● WorkflowTask object

Start the agent already on a task now: a scheduled start happens immediately, a waiting agent is woken, and a stopped, handed-back, failed or finished one opens a fresh session on the same budget. Fails while the agent is working or waiting on a person.

TaskMutations.startTaskAgent.taskId ● Long! non-null scalar

TaskMutations.answerAgentRequest ● AgentSessionRequest object

Answer the agent's pending request on a task: approve, reject with a message, approve with edited arguments, or reply to its question. Answering wakes the agent. Only the request's target (or an agent administrator) may answer.

TaskMutations.answerAgentRequest.agentSessionRequestId ● Long! non-null scalar

TaskMutations.answerAgentRequest.approved ● Boolean scalar

Approval only: true to approve, false to reject. Ignored for a question.

TaskMutations.answerAgentRequest.text ● String scalar

The answer to a question, or the reason for rejecting a tool call (the agent sees it and adapts).

TaskMutations.answerAgentRequest.editedArguments ● String scalar

Approval only: arguments edited before approving, re-validated against the tool's schema.

TaskMutations.answerAgentRequest.formData ● String scalar

Form-backed question only: the SurveyJS answers JSON, validated against the form frozen onto the request. Required when the request carries a form; ignored otherwise.

TaskMutations.answerAgentRequest.allowUploadSite ● Boolean scalar

Upload approvals only: also add the card's destination site to the agent's upload sites. Requires agent-management permission.

TaskMutations.decideAgentPlan ● WorkflowTask object

Approve the plan a Plan-then-execute agent proposed, starting a fresh autonomous session that carries it out, or send the plan back with a message for the agent to re-plan.

TaskMutations.decideAgentPlan.taskId ● Long! non-null scalar

TaskMutations.decideAgentPlan.approved ● Boolean! non-null scalar

TaskMutations.decideAgentPlan.message ● String scalar

When rejecting: what to change. The agent re-plans with this in context, and it counts as a wake-up.

TaskMutations.rateAgentTask ● AgentTaskSessionView object

Rate an agent's finished work on a task (Worked / Partly / Wrong) with a comment. Offered on finished sessions only; the task's owner, their team or an agent administrator may rate. Re-rating overwrites. Returns the refreshed Agent tab view.

TaskMutations.rateAgentTask.agentSessionId ● Long! non-null scalar

TaskMutations.rateAgentTask.rating ● String! non-null scalar

Worked, Partly or Wrong

TaskMutations.rateAgentTask.comment ● String scalar

What should have happened. The feedback interviewer works from it.

TaskMutations.submitTaskForm ● WorkflowTask object

Submit the member's answers to the task's form (SurveyJS result JSON). Fails if the task has no form or was already submitted; auto-completes the task when the form is configured to.

TaskMutations.submitTaskForm.taskId ● Long! non-null scalar

TaskMutations.submitTaskForm.formData ● String! non-null scalar

TaskMutations.requestFormUploadUrl ● FormUploadTicket object

Request a signed direct-upload ticket for a file attachment on the task's form. Assignee-only; enforces the per-file size cap, MIME allowlist and org storage quota. The browser POSTs the file to the returned url with the given fields, then stores objectKey as the SurveyJS file value.

TaskMutations.requestFormUploadUrl.taskId ● Long! non-null scalar

TaskMutations.requestFormUploadUrl.fieldName ● String! non-null scalar

TaskMutations.requestFormUploadUrl.fileName ● String! non-null scalar

TaskMutations.requestFormUploadUrl.contentType ● String! non-null scalar

TaskMutations.requestFormUploadUrl.declaredSize ● Long! non-null scalar

TaskMutations.resolveFormDownloadUrl ● String scalar

Resolve a short-lived signed download URL (attachment disposition) for a previously-uploaded form attachment. Always org-scoped; beyond that, a task attachment is restricted to members who can view the task, and an attachment uploaded through a public share link requires canManageForms (reading it is part of reading the response).

TaskMutations.resolveFormDownloadUrl.objectKey ● String! non-null scalar

TaskMutations.deleteTask ● Boolean scalar

Delete a task

TaskMutations.deleteTask.taskId ● Long! non-null scalar

TaskMutations.batchUpdateTasks ● [WorkflowTask!] list object

Apply the same changes to many tasks at once (fields left null are unchanged)

TaskMutations.batchUpdateTasks.taskIds ● [Long!]! non-null scalar

TaskMutations.batchUpdateTasks.completed ● Boolean scalar

TaskMutations.batchUpdateTasks.priority ● String scalar

TaskMutations.batchUpdateTasks.assignedTo ● Long scalar

TaskMutations.batchUpdateTasks.dueDate ● LocalDate scalar

TaskMutations.batchUpdateTasks.changeTeam ● Boolean! non-null scalar

TaskMutations.batchUpdateTasks.teamId ● Long scalar

TaskMutations.batchUpdateTasks.assignment ● TaskAssignmentInput input

TaskMutations.batchAppendTaskNotes ● [WorkflowTask!] list object

Append a note to many tasks at once (append-only; never overwrites existing notes)

TaskMutations.batchAppendTaskNotes.taskIds ● [Long!]! non-null scalar

TaskMutations.batchAppendTaskNotes.text ● String! non-null scalar

TaskMutations.batchDeleteTasks ● Int scalar

Delete many tasks at once. Returns the number deleted.

TaskMutations.batchDeleteTasks.taskIds ● [Long!]! non-null scalar

Returned By

tasks mutation