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!]
  ): 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
  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
  ): [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.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.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.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