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. The result is paginated, so the command accepts --page and --page-size and reports a pagination object in the envelope with total_records, total_pages, current_page_number, and page_size. See Pagination.

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)
`--task-id`	`string`	No		Filter to a single task’s entries by task ID
`--user-email`	`string`	No		Filter to a single user’s entries by email

Pass --task-id to narrow the result to one task, which is how you read the hours logged against a single task without filtering the whole project by hand. Task IDs come from projects show.

neetoinvoice time-entries list \
  --client 7c1f5e2a9b \
  --project 89d1b47d9f36af3c9ecf \
  --task-id 4f2a91c7-3ebd-4c1a-9f77-58ac2d6e0b41 \
  --start-date 2026-07-01 \
  --end-date 2026-07-31

{
  "data": [
    {
      "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"
    }
  ],
  "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>"
    }
  ],
  "pagination": {
    "total_records": 42,
    "total_pages": 2,
    "current_page_number": 1,
    "page_size": 30
  }
}

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.
--user-email - the email of the user the entry belongs to.

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`	Yes		Email of the user the time entry belongs to

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 \
  --user-email oliver@example.com

Required arguments

<time-entry-id> - the entry’s record ID.
--user-email - the email of the user the entry belongs to.

Flag	Type	Required	Default	Description
`--user-email`	`string`	Yes		Email of the user the time entry belongs to

{
  "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