> ## Documentation Index
> Fetch the complete documentation index at: https://sdk.docs.xano.com/llms.txt
> Use this file to discover all available pages before exploring further.

# xanosdk pull

> Refresh the backend of this project from a live one — rewrites the files it decodes, keeps and names files you added, and lists and confirms first.

## Usage

```bash theme={null}
xanosdk pull [source] [options]
```

## Backends

| Slot | Accepts | When omitted |
| - | - | - |
| `<source>` | workspace, ephemeral, ephemeral:\<name>, local, local:\<name>, tenant:\<name>, or release:\<name> | The backend this project last deployed to |

## Flags

| Flag | Description |
| - | - |
| `--yes, -y` | Rewrite without asking (required when there is no terminal), over uncommitted changes and a lock that shares no identity with the source too — files you added are still kept |
| `--no-secrets` | Find the documentation tokens and write none — for a machine where a secret on disk is not wanted. The tree still declares the gates, so a later deploy refuses rather than clearing one |
| `--backend-dir <path>` | The backend directory to refresh (its decoded files are rewritten, files you added are kept), when this project does not keep it in xano/ and nothing on disk says so |
| `--skip-roundtrip` | Do not check that the written tree re-exports as it was pulled (offline; no network, no deploy) |
| `--branch <label>` | Read this branch of the workspace instead of the live one (`workspace` only) |
| `--origin <origin>` | Xano OAuth host for `login` and a XANO\_REFRESH\_TOKEN exchange (default: \$XANO\_ORIGIN) |
| `--config <path>` | Explicit credential file (default: \$XANO\_CONFIG) |
| `--local-auth` | Use the project-local ./.xano/auth.json instead of the shared cache |

Global flags are listed in the [CLI overview](/reference/cli).

***

*Generated from @xano/sdk 1.0.9.*


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