> ## Documentation Index
> Fetch the complete documentation index at: https://ai-development-environment.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# startWorktreeSyncBatch

> Persist and start a background Bulk Sync batch.



**mutation** `startWorktreeSyncBatch(input: StartWorktreeSyncBatchInput!): WorktreeSyncBatch!`

## Arguments

**`input`**: `StartWorktreeSyncBatchInput!` (required)

Selection and page scope.

## Returns

`WorktreeSyncBatch!`

**`id`**: `ID!`

Stable batch identifier.

---

**`appId`**: `ID`

App scope, or null for the global worktrees page.

---

**`agentId`**: `ID`

Global agent focus when the batch was started.

---

**`status`**: `WorktreeSyncBatchStatus!`

Current batch progress.

---

**`items`**: `[WorktreeSyncItem!]!`

Worktrees selected for this batch in submission order.

---

**`createdAt`**: `String!`

ISO 8601 creation timestamp.

---

**`updatedAt`**: `String!`

ISO 8601 last progress timestamp.

---

**`finishedAt`**: `String`

ISO 8601 completion timestamp.



This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.