gws-workflow-file-announce

1# workflow +file-announce
2 
3> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
4 
5Announce a Drive file in a Chat space
6 
7## Usage
8 
9```bash
10gws workflow +file-announce --file-id <ID> --space <SPACE>
11```
12 
13## Flags
14 
15| Flag | Required | Default | Description |
16|------|----------|---------|-------------|
17| `--file-id` | ✓ | — | Drive file ID to announce |
18| `--space` | ✓ | — | Chat space name (e.g. spaces/SPACE_ID) |
19| `--message` | — | — | Custom announcement message |
20| `--format` | — | — | Output format: json (default), table, yaml, csv |
21 
22## Examples
23 
24```bash
25gws workflow +file-announce --file-id FILE_ID --space spaces/ABC123
26gws workflow +file-announce --file-id FILE_ID --space spaces/ABC123 --message 'Check this out!'
27```
28 
29## Tips
30 
31- This is a write command — sends a Chat message.
32- Use `gws drive +upload` first to upload the file, then announce it here.
33- Fetches the file name from Drive to build the announcement.
34 
35## See Also
36 
37- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
38- [gws-workflow](../gws-workflow/SKILL.md) — All cross-service productivity workflows commands