Skip to content

odoo-work-cli entries update

NAME

odoo-work-cli-entries-update - Update an existing timesheet entry

SYNOPSIS

odoo-work-cli entries update [--date YYYY-MM-DD] [--description TEXT] [--dry-run] [--hours H] [--project-id ID] [--task-id ID] [--json | --format FORMAT] ID

DESCRIPTION

Change the timesheet entry ID. Only the fields whose flags are given are written; at least one flag is required. --description must not be empty. The entry is read first, so an unknown ID fails with not_found before anything is written. Odoo may refuse changes to validated entries (access_denied).

With --dry-run the flags are merged into the entry, the result is validated (project and task are resolved) and printed; nothing is written. Entries of the same day with the same project, task and description are reported as possible duplicates.

OPTIONS

--date YYYY-MM-DD

New day, YYYY-MM-DD.

string; optional

--description TEXT

New description TEXT.

string; optional

--dry-run

Validate and print the entry that would be written, without writing it.

flag; optional

--hours H

New hours, decimal (2.5) or H:MM (2:30).

string; optional

--project-id ID

New project ID.

integer; optional

--task-id ID

New task ID.

integer; optional

GLOBAL OPTIONS

--format FORMAT

Output FORMAT: table, json or jsonl.

one of table, json, jsonl; optional; default: table

--json

Shorthand for --format json.

flag; optional

--backend BACKEND

BACKEND: odoo or fake (offline, made-up data; env ODOO_WORK_CLI_BACKEND).

string; optional; default: odoo; env: ODOO_WORK_CLI_BACKEND

--config FILE

Read only the config FILE (skip discovery).

string; optional

-h, --help
Print the help of the command and exit.

OUTPUT

Prints "Updated entry ID". With --dry-run, "Dry run: would update this entry; nothing was written." followed by the entry, and a warning per possible duplicate.

With --json the updated entry. With --dry-run and --json the entry as it would be, with dry_run true and duplicates (entry_dry_run.schema.json).

Fields of entry.schema.json:

id
integer
date
string (YYYY-MM-DD)
project_id
integer or null
project
string or null
task_id
integer or null
task
string or null
description
string
hours
number
minutes
integer
employee
string or null
status
string or null
company
string or null

Fields of entry_dry_run.schema.json: those of entry.schema.json, except:

id

null for add: the entry does not exist yet.

integer or null

dry_run
always true
duplicates

Entries of the same day with the same project, task and description.

array of object (entry.schema.json)

ENVIRONMENT

ODOO_URL
Odoo server URL; overrides url from the config files.
ODOO_DATABASE
Odoo database name; overrides database.
ODOO_USERNAME
Odoo login, usually an e-mail address; overrides username.
ODOO_PASSWORD
Odoo API key, used for XML-RPC. Despite the name, not the login password.
ODOO_WEB_PASSWORD
Odoo login password, used for the web session of clock in and clock out.
ODOO_TOTP_SECRET
TOTP secret (base32 or otpauth:// URL) for accounts with two-factor authentication.
ODOO_OP_TIMEOUT
Timeout of the 1Password call that resolves [op_secrets], a Go duration; default 5s.
ODOO_WORK_CLI_NO_OP
If 1, true, yes or on, [op_secrets] is ignored and the 1Password CLI is never called.
ODOO_WORK_CLI_BACKEND
Backend, odoo (default) or fake; --backend overrides it.
ODOO_WORK_CLI_FAKE_STATE
State file of the fake backend; default odoo-work-cli-fake-state.json in the temporary directory.
XDG_CONFIG_HOME
Base directory of the global config file; default ~/.config.

FILES

~/.config/odoo-work-cli/config.toml
Global configuration ($XDG_CONFIG_HOME/odoo-work-cli/config.toml if XDG_CONFIG_HOME is set). Created by odoo-work-cli config install.
.odoo-work-cli.toml
Configuration of a directory tree. Every such file from the filesystem root down to the current directory is merged over the global file, the deepest last. --config FILE loads only FILE instead.
$TMPDIR/odoo-work-cli-fake-state.json
State of the fake backend (--backend fake); ODOO_WORK_CLI_FAKE_STATE sets another path. Delete it to start over with the seed data.

EXIT STATUS

0 on success, 1 on any error, including usage errors. With --json or --format json|jsonl the error is printed on standard output as one JSON object, {"error": {"kind": KIND, "message": TEXT}}, and nothing on standard error; otherwise as "Error: TEXT" on standard error, after usage errors followed by the usage.

Error kinds this command can fail with:

auth
Authentication failed: wrong API key or login password, TOTP rejected.
access_denied
Odoo's access rules forbid the operation, e.g. attendance writes without the Attendance Officer right.
not_found
The record does not exist or is not visible.
validation
Invalid input: unknown flag, bad argument, malformed date, time or hours, a time in the future, an unknown project.
network
Odoo cannot be reached: DNS, connection refused, timeout, TLS.
config
The local configuration is missing or invalid.
secrets_locked
1Password is locked or unreachable, so op:// references could not be resolved.
internal
Anything else: an unexpected Odoo response or a bug.

EXAMPLES

Preview a correction of the hours:

$ odoo-work-cli entries update 4018 --hours 2:00 --dry-run
Dry run: would update this entry; nothing was written.
  ID:          4018
  Date:        2026-04-09
  Project:     Lighthouse Portal (1)
  Task:        Code review (13)
  Hours:       2:00
  Description: Review fuzzy matching

Change the description:

$ odoo-work-cli entries update 4018 --description "Review fuzzy matching, round 2"
Updated entry 4018

SEE ALSO