@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/tasks.d.ts

@@ -0,0 +1,813 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.tasks` (Tasks): 25 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"assign_task_executor_tasks__task_id__assignment_put">;
+ *
+ * Reference with examples: tasks.md
+ */
+/* eslint-disable */
+
+/** `g8.api.tasks.<member>` -> the operationId it calls. */
+export interface TasksMembers {
+  assignTaskExecutor: "assign_task_executor_tasks__task_id__assignment_put";
+  createGlobalTask: "create_global_task_tasks_post";
+  createSubtask: "create_subtask_tasks__task_id__subtasks_post";
+  createTask: "create_task_contacts__contact_id__tasks_post";
+  createTaskCopies: "create_task_copies_tasks__task_id__copies_post";
+  createTaskReply: "create_task_reply_tasks__task_id__replies_post";
+  deleteSubtask: "delete_subtask_tasks__task_id__subtasks__subtask_id__delete";
+  deleteTask: "delete_task_tasks__task_id__delete";
+  deleteTaskReply: "delete_task_reply_tasks_replies__reply_id__delete";
+  getTask: "get_task_tasks__task_id__get";
+  getTaskRecord: "get_task_record_tasks_records__entity_type___entity_id__get";
+  getTaskSettings: "get_task_settings_tasks_settings_get";
+  listAllTasks: "list_all_tasks_tasks_get";
+  listContactTasks: "list_contact_tasks_contacts__contact_id__tasks_get";
+  listSubtasks: "list_subtasks_tasks__task_id__subtasks_get";
+  listTaskReplies: "list_task_replies_tasks__task_id__replies_get";
+  reopenTaskThread: "reopen_task_thread_tasks__task_id__resolve_delete";
+  resolveTaskThread: "resolve_task_thread_tasks__task_id__resolve_post";
+  snoozeTaskReminder: "snooze_task_reminder_tasks__task_id__snooze_post";
+  startTaskExecution: "start_task_execution_tasks__task_id__start_post";
+  taskExecutionHistory: "task_execution_history_tasks__task_id__execution_get";
+  updateSubtask: "update_subtask_tasks__task_id__subtasks__subtask_id__put";
+  updateTask: "update_task_tasks__task_id__patch";
+  updateTaskReply: "update_task_reply_tasks_replies__reply_id__put";
+  updateTaskSettings: "update_task_settings_tasks_settings_put";
+}
+
+/** Input and output of every `g8.api.tasks` operation, keyed by operationId. */
+export interface TasksOperations {
+  /**
+   * PUT /tasks/{task_id}/assignment
+   * Assign Task Executor
+   * tier: write · scope: tasks:write
+   */
+  assign_task_executor_tasks__task_id__assignment_put: {
+    input: {
+    path: {
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TaskAssignmentRequest;
+  };
+    output: ApiResponse_TaskAssignmentResult_;
+  };
+  /**
+   * POST /tasks
+   * Create Global Task
+   * tier: write · scope: tasks:write
+   */
+  create_global_task_tasks_post: {
+    input: {
+    headers?: {
+      "idempotency-key"?: string | null;
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TaskCreateRequest;
+  };
+    output: ApiResponse_TaskResponse_;
+  };
+  /**
+   * POST /tasks/{task_id}/subtasks
+   * Create Subtask
+   * tier: write · scope: tasks:write
+   */
+  create_subtask_tasks__task_id__subtasks_post: {
+    input: {
+    path: {
+      /** Parent task id (UUID). */
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SubtaskCreateRequest;
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * POST /contacts/{contact_id}/tasks
+   * Create Task
+   * tier: write · scope: tasks:write
+   */
+  create_task_contacts__contact_id__tasks_post: {
+    input: {
+    path: {
+      /** Contact ID */
+      contact_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TaskCreateRequest;
+  };
+    output: ApiResponse_TaskResponse_;
+  };
+  /**
+   * POST /tasks/{task_id}/copies
+   * Create Task Copies
+   * tier: write · scope: tasks:write
+   */
+  create_task_copies_tasks__task_id__copies_post: {
+    input: {
+    path: {
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TaskCopyRequest;
+  };
+    output: unknown;
+  };
+  /**
+   * POST /tasks/{task_id}/replies
+   * Create Task Reply
+   * tier: write · scope: tasks:write
+   */
+  create_task_reply_tasks__task_id__replies_post: {
+    input: {
+    path: {
+      /** Task id (UUID). */
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TaskReplyCreateRequest;
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * DELETE /tasks/{task_id}/subtasks/{subtask_id}
+   * Delete Subtask
+   * tier: destructive · scope: tasks:delete
+   */
+  delete_subtask_tasks__task_id__subtasks__subtask_id__delete: {
+    input: {
+    path: {
+      /** Parent task id (UUID). */
+      task_id: string;
+      /** Subtask id (UUID). */
+      subtask_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * DELETE /tasks/{task_id}
+   * Delete Task
+   * tier: destructive · scope: tasks:delete
+   */
+  delete_task_tasks__task_id__delete: {
+    input: {
+    path: {
+      /** Task ID */
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * DELETE /tasks/replies/{reply_id}
+   * Delete Task Reply
+   * tier: destructive · scope: tasks:delete
+   */
+  delete_task_reply_tasks_replies__reply_id__delete: {
+    input: {
+    path: {
+      /** Reply id (UUID). */
+      reply_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * GET /tasks/{task_id}
+   * Get Task
+   * tier: read · scope: tasks:read
+   */
+  get_task_tasks__task_id__get: {
+    input: {
+    path: {
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_TaskResponse_;
+  };
+  /**
+   * GET /tasks/records/{entity_type}/{entity_id}
+   * Get Task Record
+   * tier: read · scope: tasks:read
+   */
+  get_task_record_tasks_records__entity_type___entity_id__get: {
+    input: {
+    path: {
+      /** Record type, e.g. `contact`, `company`, `deal`. */
+      entity_type: string;
+      /** Record id. */
+      entity_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * GET /tasks/settings
+   * Get Task Settings
+   * tier: read · scope: tasks:read
+   */
+  get_task_settings_tasks_settings_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * GET /tasks
+   * List All Tasks
+   * tier: read · scope: tasks:read
+   */
+  list_all_tasks_tasks_get: {
+    input: {
+    query?: {
+      /** Filter by status (open, completed) */
+      status?: string | null;
+      /** Filter by priority */
+      priority?: number | null;
+      /** Filter by assignee user ID */
+      assignee_id?: string | null;
+      /** Filter by creator (email or user ID) */
+      created_by?: string | null;
+      /** Filter by task type (call, email, meeting, ...) */
+      task_type?: string | null;
+      /** Filter by linked entity type (contact, company, deal, team_member) */
+      entity_type?: string | null;
+      /** Filter by linked entity ID (pair with entity_type) */
+      entity_id?: string | null;
+      /** Filter to tasks from a specific meeting */
+      source_meeting_id?: number | null;
+      /** Search by task title */
+      search?: string | null;
+      /** Max tasks to return (default 100, max 200) */
+      limit?: number;
+      /** Number of tasks to skip */
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_TaskResponse__;
+  };
+  /**
+   * GET /contacts/{contact_id}/tasks
+   * List Contact Tasks
+   * tier: read · scope: tasks:read
+   */
+  list_contact_tasks_contacts__contact_id__tasks_get: {
+    input: {
+    path: {
+      /** Contact ID */
+      contact_id: number;
+    };
+    query?: {
+      /** Filter by status (open, completed) */
+      status?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_TaskResponse__;
+  };
+  /**
+   * GET /tasks/{task_id}/subtasks
+   * List Subtasks
+   * tier: read · scope: tasks:read
+   */
+  list_subtasks_tasks__task_id__subtasks_get: {
+    input: {
+    path: {
+      /** Parent task id (UUID). */
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmCollectionPayload_;
+  };
+  /**
+   * GET /tasks/{task_id}/replies
+   * List Task Replies
+   * tier: read · scope: tasks:read
+   */
+  list_task_replies_tasks__task_id__replies_get: {
+    input: {
+    path: {
+      /** Task id (UUID). */
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmCollectionPayload_;
+  };
+  /**
+   * DELETE /tasks/{task_id}/resolve
+   * Reopen Task Thread
+   * tier: destructive · scope: tasks:delete
+   */
+  reopen_task_thread_tasks__task_id__resolve_delete: {
+    input: {
+    path: {
+      /** Task id (UUID). */
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * POST /tasks/{task_id}/resolve
+   * Resolve Task Thread
+   * tier: write · scope: tasks:write
+   */
+  resolve_task_thread_tasks__task_id__resolve_post: {
+    input: {
+    path: {
+      /** Task id (UUID). */
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: ResolveThreadRequest;
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * POST /tasks/{task_id}/snooze
+   * Snooze Task Reminder
+   * tier: write · scope: tasks:write
+   */
+  snooze_task_reminder_tasks__task_id__snooze_post: {
+    input: {
+    path: {
+      /** Task id (UUID). */
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SnoozeTaskRequest;
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * POST /tasks/{task_id}/start
+   * Start Task Execution
+   * tier: billable · scope: tasks:run
+   */
+  start_task_execution_tasks__task_id__start_post: {
+    input: {
+    path: {
+      task_id: string;
+    };
+    headers: {
+      "idempotency-key": string;
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_TaskStartResult_;
+  };
+  /**
+   * GET /tasks/{task_id}/execution
+   * Task Execution History
+   * tier: read · scope: tasks:read
+   */
+  task_execution_history_tasks__task_id__execution_get: {
+    input: {
+    path: {
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_TaskExecutionHistory_;
+  };
+  /**
+   * PUT /tasks/{task_id}/subtasks/{subtask_id}
+   * Update Subtask
+   * tier: write · scope: tasks:write
+   */
+  update_subtask_tasks__task_id__subtasks__subtask_id__put: {
+    input: {
+    path: {
+      /** Parent task id (UUID). */
+      task_id: string;
+      /** Subtask id (UUID). */
+      subtask_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SubtaskUpdateRequest;
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * PATCH /tasks/{task_id}
+   * Update Task
+   * tier: write · scope: tasks:write
+   */
+  update_task_tasks__task_id__patch: {
+    input: {
+    path: {
+      /** Task ID */
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TaskUpdateRequest;
+  };
+    output: ApiResponse_TaskResponse_;
+  };
+  /**
+   * PUT /tasks/replies/{reply_id}
+   * Update Task Reply
+   * tier: write · scope: tasks:write
+   */
+  update_task_reply_tasks_replies__reply_id__put: {
+    input: {
+    path: {
+      /** Reply id (UUID). */
+      reply_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TaskReplyUpdateRequest;
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+  /**
+   * PUT /tasks/settings
+   * Update Task Settings
+   * tier: write · scope: tasks:write
+   */
+  update_task_settings_tasks_settings_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TaskCompletionSettingsRequest;
+  };
+    output: ApiResponse_CrmRecordPayload_;
+  };
+}
+
+// 27 schemas referenced above (the same as G8Contract.<Name>).
+
+export interface ApiResponse_CrmCollectionPayload_ {
+  data: CrmCollectionPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_CrmRecordPayload_ {
+  data: CrmRecordPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_TaskAssignmentResult_ {
+  data: TaskAssignmentResult;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_TaskExecutionHistory_ {
+  data: TaskExecutionHistory;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_TaskResponse_ {
+  data: TaskResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_TaskStartResult_ {
+  data: TaskStartResult;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_dict_ {
+  data: Record<string, unknown>;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_list_TaskResponse__ {
+  data: Array<TaskResponse>;
+  pagination?: PaginationMeta | null;
+}
+
+/** An open envelope for a LIST result, so a bare list keeps its shape. */
+export interface CrmCollectionPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/**
+ * An open envelope for one record, one dashboard or one job receipt.
+ *
+ * Open because most of these reads are COMPUTED shapes - an engagement
+ * summary, a next-best-step, an intelligence status - that grow with the
+ * product, and dropping a field from an advisory read makes it say "nothing
+ * to report" rather than "we did not tell you".
+ */
+export type CrmRecordPayload = Record<string, unknown>;
+
+export interface PaginationMeta {
+  /** Whether there are more pages */
+  has_next: boolean;
+  /** Items per page */
+  limit: number;
+  /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
+  next_cursor?: string | null;
+  /** Current page number (1-indexed) */
+  page: number;
+  /** Total number of items */
+  total: number;
+}
+
+/**
+ * Mark a discussion thread resolved.
+ *
+ * Distinct from completing the task: a task can be done with an unresolved
+ * thread and vice versa. Idempotent - re-resolving returns the existing row.
+ */
+export interface ResolveThreadRequest {
+  /** Why it was resolved. */
+  resolution_note?: string | null;
+}
+
+/** Push a task's reminder out by N minutes from now. */
+export interface SnoozeTaskRequest {
+  /** Minutes from now to fire the next reminder. */
+  minutes: number;
+}
+
+/**
+ * Create a subtask under an existing task.
+ *
+ * `entity_type`/`entity_id` are the record the subtask hangs off, and they
+ * are required by the app's own model - a subtask is not implicitly attached
+ * to its parent's record.
+ */
+export interface SubtaskCreateRequest {
+  /** Assignee id. */
+  assignee_id?: string | null;
+  /** Assignee display name. */
+  assignee_name?: string | null;
+  /** Free-text body. */
+  description?: string | null;
+  /** ISO 8601 due date. */
+  due_date?: string | null;
+  /** Record id. */
+  entity_id: string;
+  /** Record type: contact | company | deal. */
+  entity_type: string;
+  /** Ignored - the parent is the task in the path. Present for parity. */
+  parent_task_id?: string | null;
+  /** Priority. */
+  priority?: number | null;
+  /** Additional `{entity_type, entity_id}` records to link. When set, the FIRST entry becomes the primary record. */
+  records?: Array<Record<string, unknown>> | null;
+  /** ISO 8601 UTC reminder time. Omit for no reminder. */
+  reminder_at?: string | null;
+  /** Page the subtask was raised from. */
+  source_url?: string | null;
+  /** Position among sibling subtasks. */
+  subtask_sort_order?: number | null;
+  /** Labels (max 20). */
+  tags?: Array<string> | null;
+  /** Task type. */
+  task_type?: string | null;
+  /** Subtask title. */
+  title: string;
+  /** public | team | private. Omit for the org default. */
+  visibility?: string | null;
+}
+
+/**
+ * Patch a subtask. Omitted fields are left alone.
+ *
+ * `records` is the exception: an EMPTY list clears every record link, while
+ * omitting it leaves the links unchanged.
+ */
+export interface SubtaskUpdateRequest {
+  /** Send explicit null to unassign. */
+  assignee_id?: string | null;
+  /** Assignee display name. */
+  assignee_name?: string | null;
+  /** Explicitly remove the reminder. */
+  clear_reminder?: boolean | null;
+  /** New body. */
+  description?: string | null;
+  /** ISO 8601. Send explicit null to clear. */
+  due_date?: string | null;
+  /** Optimistic-concurrency guard. When set and the stored row is newer, the update is refused instead of overwriting. */
+  expected_updated_at?: string | null;
+  /** New priority. */
+  priority?: number | null;
+  /** Replace record links. Empty list clears them; omit to leave alone. */
+  records?: Array<Record<string, unknown>> | null;
+  /** ISO 8601 UTC reminder. */
+  reminder_at?: string | null;
+  /** New status. */
+  status?: string | null;
+  /** Replace the labels. */
+  tags?: Array<string> | null;
+  /** Send explicit null to clear. */
+  task_type?: string | null;
+  /** New title. */
+  title?: string | null;
+  /** public | team | private. */
+  visibility?: string | null;
+}
+
+export interface TaskAssignmentRequest {
+  agent_id?: string | null;
+  expected_updated_at: string;
+}
+
+export interface TaskAssignmentResult {
+  assigned: boolean;
+  execution_started: boolean;
+}
+
+/** Mirrors `UpdateTaskSettingsRequest`. The app accepts exactly these three modes. */
+export interface TaskCompletionSettingsRequest {
+  /** How a parent task completes relative to its subtasks. */
+  parent_completion_mode?: ("manual" | "auto_complete" | "require_subtasks_done") | null;
+}
+
+export interface TaskCopyRequest {
+  assignee_ids: Array<string>;
+  expected_updated_at: string;
+  request_id: string;
+}
+
+export interface TaskCreateRequest {
+  /** User ID to assign the task to */
+  assignee_id?: string | null;
+  /** Task description */
+  description?: string | null;
+  /** Due date (ISO 8601) */
+  due_date?: string | null;
+  entity_id?: string | null;
+  entity_type?: string | null;
+  /** Parent task UUID. When set, this task is inserted as a subtask of the parent. Subtasks cannot themselves have subtasks (one level deep). */
+  parent_task_id?: string | null;
+  /** Priority (0=none, 1=high, 2=medium, 3=low; historical 4=low is preserved) */
+  priority?: number | null;
+  /** Optional related records: contact, company, deal, lead, application, team_member, or campaign (Studio). An empty list leaves the task standalone. */
+  records?: Array<Record<string, string>> | null;
+  source_url?: string | null;
+  /** Sort position within the parent's subtasks. When omitted on a subtask create, the handler appends to the end. */
+  subtask_sort_order?: number | null;
+  tags?: Array<string> | null;
+  /** Activity type, such as call or meeting */
+  task_type?: string | null;
+  /** Task title */
+  title: string;
+}
+
+export interface TaskExecutionHistory {
+  runs: Array<TaskExecutionRun>;
+}
+
+export interface TaskExecutionRun {
+  completed_at: string | null;
+  continued_after_reply?: boolean;
+  created_at: string;
+  current_step: string | null;
+  details_available: boolean;
+  next_action: string | null;
+  session_id: string | null;
+  status: string;
+  work_item_id: string;
+}
+
+/** Post a reply on a task's discussion thread. Internal to the org. */
+export interface TaskReplyCreateRequest {
+  /** Avatar to show beside the reply. */
+  author_avatar_url?: string | null;
+  /** Reply text. */
+  body: string;
+  /** Users to notify. */
+  mentioned_user_ids?: Array<string>;
+}
+
+/** Edit a reply. Author only. */
+export interface TaskReplyUpdateRequest {
+  /** Replacement text. */
+  body: string;
+}
+
+export interface TaskResponse {
+  assignee_id?: string | null;
+  assignee_name?: string | null;
+  completed_subtask_count?: number | null;
+  created_at?: string | null;
+  created_by?: string | null;
+  description?: string | null;
+  due_date?: string | null;
+  entity_id?: string | null;
+  entity_label?: string | null;
+  entity_type?: string | null;
+  execution_id?: string | null;
+  executor_agent_id?: string | null;
+  executor_agent_name?: string | null;
+  executor_type?: "human" | "agent";
+  id: string;
+  links?: Array<Record<string, unknown>>;
+  parent_task_id?: string | null;
+  priority?: number | null;
+  reminder_at?: string | null;
+  reminder_sent_at?: string | null;
+  source_external_id?: string | null;
+  source_meeting_id?: number | null;
+  source_meeting_start_time?: string | null;
+  source_meeting_title?: string | null;
+  source_transcript_id?: string | null;
+  source_url?: string | null;
+  status?: string | null;
+  subtask_count?: number | null;
+  subtask_sort_order?: number | null;
+  tags?: Array<string>;
+  task_type?: string | null;
+  title: string;
+  updated_at?: string | null;
+  visibility?: string | null;
+}
+
+export interface TaskStartResult {
+  already_started?: boolean;
+  message?: string | null;
+  session_id?: string | null;
+  work_item_id: string;
+  workflow_started: boolean;
+}
+
+export interface TaskUpdateRequest {
+  /** User ID to assign the task to */
+  assignee_id?: string | null;
+  /** Task description */
+  description?: string | null;
+  /** Due date (ISO 8601) */
+  due_date?: string | null;
+  expected_updated_at?: string | null;
+  /** New parent task UUID. Re-parents this task into a subtask of the given parent. Parent must exist and must not itself be a subtask. */
+  parent_task_id?: string | null;
+  /** Priority (0=none, 1=high, 2=medium, 3=low; historical 4=low is preserved) */
+  priority?: number | null;
+  /** Replace related records; an empty list removes all links and makes the task standalone. Omit to preserve existing links. */
+  records?: Array<Record<string, string>> | null;
+  /** Task status (open, completed) */
+  status?: string | null;
+  /** New sort position within the parent's subtasks (reorder). */
+  subtask_sort_order?: number | null;
+  tags?: Array<string> | null;
+  /** Activity type; null removes the saved type */
+  task_type?: string | null;
+  /** Task title */
+  title?: string | null;
+}