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

# Pull Event

> Use the suprsend event pull CLI command to download event definitions and the event schema mapping file from your workspace to a local directory.

Download event definitions from a workspace to local files. Saves event data and an `event_schema_mapping.json` file to the output directory. This action does not delete existing events; instead, it overwrites events with the same name or creates new ones. <br /><br />
By default, pulled events are stored in the `suprsend/event/` directory, but you can change the destination using the -d flag.

## Syntax

```bash theme={"system"}
suprsend event pull [flags]
```

## Flags

| Flag | Description | Default |
| - | - | - |
| `-h, --help` | Show help for the command | – |
| `-d, --dir string` | Directory to save event files to | `./suprsend/event` |
| `-f, --force` | Skip directory confirmation prompt, use default path | – |

## Example

```bash theme={"system"}
# Pull all events to default directory
suprsend event pull

# Pull events into custom directory path
suprsend event pull --dir dev-environment/events

# Pull events from production workspace
suprsend event pull --workspace production
```


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