> ## 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

> Pull events from workspace to 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
```