time-entries

Time entries are hours logged by a user against a project’s task. Unbilled entries are the raw material for invoices. For fields and response details, see the API reference.

--task-id is a task’s record ID. Get it from projects show, or see Getting the task ID.

Sample responses on this page show the JSON envelope (--json). Pretty output is the default on a terminal and its columns adapt to width. See Output formats.

time-entries list

List a project’s unbilled time entries. This is the only paginated command in the CLI, so it accepts --page and --page-size.

neetoinvoice time-entries list \
  --client 7c1f5e2a9b \
  --project 89d1b47d9f36af3c9ecf \
  --start-date 2026-07-01 \
  --end-date 2026-07-31

Flag	Type	Required	Default	Description
`--client`	`string`	Yes		Client identifier
`--end-date`	`string`	No		Filter entries recorded on or before this date (YYYY-MM-DD)
`--page`	`int`	No	`0`	Page number
`--page-size`	`int`	No	`0`	Items per page (max 100)
`--project`	`string`	Yes		Project identifier
`--start-date`	`string`	No		Filter entries recorded on or after this date (YYYY-MM-DD)
`--user-email`	`string`	No		Filter to a single user’s entries by email

{
  "data": {
    "time_entries": [
      {
        "id": "128c1dfc-b29f-4fda-9a05-8a90e197b81b",
        "user_id": "5a2de667-243b-4da3-b090-b698a03d98da",
        "task_id": "24e6a2fe-31bb-686c-541a-9f36af3c9ecf",
        "hours": 2.5,
        "recorded_on": "2026-07-14",
        "notes": "Reviewed the new dashboard layout",
        "status": "submitted",
        "created_at": "2026-07-14T09:12:04.000Z",
        "updated_at": "2026-07-14T09:12:04.000Z",
        "user_name": "Oliver Smith",
        "user_email": "oliver@example.com",
        "task_name": "Design",
        "project_id": "f627c399-379d-4d07-a6f6-90b7c9470ac0",
        "project_name": "Website Redesign",
        "client_id": "3f0c0f87-ddc7-45f4-ad7a-c3690fa04963",
        "client_name": "Acme Corp"
      }
    ],
    "total_count": 42,
    "page": 1,
    "page_size": 30,
    "total_pages": 2,
    "next_page": 2,
    "prev_page": null
  },
  "breadcrumbs": [
    {
      "label": "Log time",
      "command": "neetoinvoice time-entries create --client <client-id> --project <project-id> --task-id <task-id> --user-email <email> --recorded-on <date> --hours <hours>"
    }
  ]
}

time-entries create

Log time against a task. --user-email is the organization user the hours belong to, which is not necessarily the signed-in user.

neetoinvoice time-entries create \
  --client 7c1f5e2a9b \
  --project 89d1b47d9f36af3c9ecf \
  --task-id 24e6a2fe-31bb-686c-541a-9f36af3c9ecf \
  --user-email oliver@example.com \
  --recorded-on 2026-07-14 \
  --hours 2.5 \
  --notes "Reviewed the new dashboard layout"

Flag	Type	Required	Default	Description
`--client`	`string`	Yes		Client identifier
`--hours`	`float64`	No	`0`	Hours spent (omit for no-hours projects)
`--is-override`	`bool`	No	`false`	Override autolock for a locked date
`--notes`	`string`	No		Notes
`--project`	`string`	Yes		Project identifier
`--recorded-on`	`string`	Yes		Date the time was recorded (YYYY-MM-DD)
`--task-id`	`string`	Yes		Task ID
`--user-email`	`string`	Yes		Email of the organization user logging the time

Pass --is-override to log against a date that autolock has already closed. Your role must permit overriding autolock.

time-entries update

Change an entry’s hours, notes, or date. Only the flags you pass are changed.

neetoinvoice time-entries update 128c1dfc-b29f-4fda-9a05-8a90e197b81b \
  --hours 3 \
  --user-email oliver@example.com

Required arguments

<time-entry-id> - the entry’s record ID. See Getting the time entry ID.

Flag	Type	Required	Default	Description
`--hours`	`float64`	No	`0`	New hours
`--is-override`	`bool`	No	`false`	Override autolock for a locked date
`--notes`	`string`	No		New notes
`--recorded-on`	`string`	No		New date (YYYY-MM-DD)
`--user-email`	`string`	No		Acting user’s email

An entry that has already been invoiced cannot be edited or deleted. Adjust the invoice instead.

time-entries delete

Delete a time entry.

neetoinvoice time-entries delete 128c1dfc-b29f-4fda-9a05-8a90e197b81b

Required arguments

<time-entry-id> - the entry’s record ID.

{
  "data": { "message": "Time entry deleted." },
  "breadcrumbs": [
    {
      "label": "List",
      "command": "neetoinvoice time-entries list --client <client-id> --project <project-id>"
    }
  ]
}

Getting Started

Commands

time-entries list

time-entries create

time-entries update

Required arguments

time-entries delete

Required arguments

​time-entries list

​time-entries create

​time-entries update

​Required arguments

​time-entries delete

​Required arguments

time-entries list

time-entries create

time-entries update

Required arguments

time-entries delete

Required arguments