1---
2name: gws-drive-upload
3description: "Google Drive: Upload a file with automatic metadata."
4metadata:
5  version: 0.22.5
6  openclaw:
7    category: "productivity"
8    requires:
9      bins:
10        - gws
11    cliHelp: "gws drive +upload --help"
12---
13 
14# drive +upload
15 
16> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
17 
18Upload a file with automatic metadata
19 
20## Usage
21 
22```bash
23gws drive +upload <file>
24```
25 
26## Flags
27 
28| Flag | Required | Default | Description |
29|------|----------|---------|-------------|
30| `<file>` | ✓ | — | Path to file to upload |
31| `--parent` | — | — | Parent folder ID |
32| `--name` | — | — | Target filename (defaults to source filename) |
33 
34## Examples
35 
36```bash
37gws drive +upload ./report.pdf
38gws drive +upload ./report.pdf --parent FOLDER_ID
39gws drive +upload ./data.csv --name 'Sales Data.csv'
40```
41 
42## Tips
43 
44- MIME type is detected automatically.
45- Filename is inferred from the local path unless --name is given.
46 
47> [!CAUTION]
48> This is a **write** command — confirm with the user before executing.
49 
50## See Also
51 
52- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
53- [gws-drive](../gws-drive/SKILL.md) — All manage files, folders, and shared drives commands
54