# vodoo helpdesk

Manage Odoo Helpdesk tickets (requires Odoo Enterprise).

<!-- This file is auto-generated by scripts/gen_cli_docs.py. Do not edit manually. -->

## Commands

### list

List helpdesk tickets.

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--stage` | TEXT | Filter by stage name |
| `--partner` | TEXT | Filter by partner name |
| `--assigned-to` | TEXT | Filter by assigned user name |
| `--limit` | INT | Maximum number of tickets (default: 50) |
| `--field` / `-f` | TEXT | Specific fields to fetch (can be used multiple times) |

### show

Show detailed ticket information.

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `ticket_id` | INT | Ticket ID |

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--field` / `-f` | TEXT | Specific fields to fetch (can be used multiple times) |
| `--html` | BOOL | Show raw HTML description instead of markdown |

### comment

Add a comment to a ticket (visible to customers).

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `ticket_id` | INT | Ticket ID |
| `message` | TEXT | Comment message |

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--author` / `-a` | INT | User ID to post as |
| `--no-markdown` | BOOL | Disable markdown to HTML conversion |

### note

Add an internal note to a ticket (not visible to customers).

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `ticket_id` | INT | Ticket ID |
| `message` | TEXT | Note message |

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--author` / `-a` | INT | User ID to post as |
| `--no-markdown` | BOOL | Disable markdown to HTML conversion |

### tags

List available helpdesk tags.

### tag

Add a tag to a ticket.

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `ticket_id` | INT | Ticket ID |
| `tag_id` | INT | Tag ID |

### chatter

Show message history/chatter for a ticket.

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `ticket_id` | INT | Ticket ID |

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--limit` | INT | Maximum number of messages to show |
| `--html` | BOOL | Show raw HTML body instead of plain text |

### attachments

List attachments for a ticket.

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `ticket_id` | INT | Ticket ID |

### download

Download a single attachment by ID.

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `attachment_id` | INT | Attachment ID |

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--output` | PATH | Output file path (defaults to attachment name) |

### download-all

Download all attachments from a ticket.

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `ticket_id` | INT | Ticket ID |

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--output` / `-o` | PATH | Output directory (defaults to current directory) |
| `--extension` / `--ext` | TEXT | Filter by file extension (e.g., pdf, jpg, png) |

### fields

List available fields or show field values for a specific ticket.

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `ticket_id` | INT | Ticket ID (optional) |

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--field-name` | TEXT | Show details for a specific field |

### set

Set field values on a ticket.

    Supports operators: =, +=, -=, *=, /=
    HTML fields (like description) automatically convert markdown to HTML.

    Examples:
        vodoo helpdesk set 42 priority=2 name="New Title"
        vodoo helpdesk set 42 user_id=5 stage_id=3
        vodoo helpdesk set 42 priority+=1
        vodoo helpdesk set 42 'tag_ids=json:[[6,0,[1,2,3]]]'
        vodoo helpdesk set 42 'description=# Heading

Paragraph text'

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `ticket_id` | INT | Ticket ID |
| `fields` | TEXT | Field assignments in format 'field=value' or 'field+=amount' |

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--no-markdown` | BOOL | Disable markdown to HTML conversion for HTML fields |

### attach

Attach a file to a ticket.

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `ticket_id` | INT | Ticket ID |
| `file_path` | PATH | Path to file to attach |

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--name` / `-n` | TEXT | Custom attachment name (defaults to filename) |

### url

Get the web URL for a ticket.

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `ticket_id` | INT | Ticket ID |

