# Sync

URL: https://docs.hanzo.ai/docs/cli/sync

> The `hanzo sync` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/sync) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/sync) · [SDKs](https://docs.hanzo.ai/docs/sdks)

Data sync: link two endpoints and keep them in step, on a webhook, on a schedule, or on demand.

[API reference →](https://docs.hanzo.ai/docs/openapi/sync)

```bash
hanzo sync list
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command                  | What it does                                                                                                                                                                                                                                                             |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `hanzo sync create`      | Declares a sync between two endpoints and returns it.                                                                                                                                                                                                                    |
| `hanzo sync get <id>`    | Returns one sync by id.                                                                                                                                                                                                                                                  |
| `hanzo sync list`        | Returns every sync link the caller's org has, each with its two endpoints, its direction and trigger policy, the time it last reconciled, and for a repo link its native copy on the forge — the address to clone it from, its default branch and whether it is in step. |
| `hanzo sync rm <id>`     | Removes one sync and tears down the outbound mirror it derived, answering 204.                                                                                                                                                                                           |
| `hanzo sync run <id>`    | Reconciles one sync now — the manual re-sync, and the initial import for a link created without run=true.                                                                                                                                                                |
| `hanzo sync update <id>` | Updates one sync's mutable policy — direction, trigger and actor — in place.                                                                                                                                                                                             |