Projects

A project belongs to a client, holds the tasks people log time against, and carries the billing method used when the work is invoiced. For fields and response details, see the API reference.

A project is addressed by its identifier, the short hex string returned by projects list. --client-id is different: it takes the client’s record id, a UUID. See Getting the project ID.

List projects

Find a project’s identifier, or list the projects a user is on.

neetoinvoice projects list --client-id 7c1f5e2a9b --status active --name website

Flag	Type	Required	Default	Description
`--client-id`	`string`	No		Filter to one client (identifier or ID)
`--name`	`string`	No		Filter by name (substring match)
`--page`	`int`	No	unset	Page number
`--page-size`	`int`	No	unset	Items per page (max 100)
`--status`	`string`	No		Filter by status: active or archived
`--user-email`	`string`	No		Filter to a user’s projects

Without --page or --page-size, the command returns every record. With either flag, the result is paginated. The envelope always has a pagination object. See Pagination. Use --name to find a project by part of its name; the match is case-insensitive.

Sample output (--json)

{
  "data": [
    {
      "id": "f627c399-379d-4d07-a6f6-90b7c9470ac0",
      "identifier": "89d1b47d9f36af3c9ecf",
      "name": "Website Redesign",
      "billing_method": "hourly_person_rate",
      "hourly_rate": null,
      "flat_amount": null,
      "currency": "USD",
      "client_id": "3f0c0f87-ddc7-45f4-ad7a-c3690fa04963",
      "status": "active",
      "requires_daily_entry": false
    }
  ],
  "breadcrumbs": [
    { "label": "Show", "command": "neetoinvoice projects show <project-id>" }
  ],
  "pagination": {
    "total_records": 1,
    "total_pages": 1,
    "current_page_number": 1,
    "page_size": 30
  }
}

On a terminal, this renders as a plain table with a page summary, the same way clients list does:

Sample output

ID                     IDENTIFIER      NAME             STATUS   CLIENT ID              REQUIRES DAILY ENTRY
────────────────────   ─────────────   ──────────────   ──────   ────────────────────   ────────────────────
f627c399-379d-4d0...   89d1b47d9f...   Website Redesign  active   3f0c0f87-ddc7-45f...   No

Page 1 of 1 (1 total records)

  Show: neetoinvoice projects show <project-id>

--client-id accepts either the client’s identifier or its record id.

Show a project

Show a project with its client, tasks, checklists, and recurring invoice settings. Use it to find the task_id that time-entries create needs.

neetoinvoice projects show 89d1b47d9f36af3c9ecf

Required arguments:

<project-id> - The project’s identifier.

Sample output (--json)

{
  "data": {
    "project": {
      "id": "f627c399-379d-4d07-a6f6-90b7c9470ac0",
      "identifier": "89d1b47d9f36af3c9ecf",
      "client_id": "3f0c0f87-ddc7-45f4-ad7a-c3690fa04963",
      "name": "Website Redesign",
      "status": "active",
      "hourly_rate": 120.0,
      "hourly_rate_with_currency": "$120.00",
      "flat_amount": null,
      "flat_amount_with_currency": null,
      "currency": "USD",
      "currency_symbol": "$",
      "creator_name": "Oliver Smith",
      "internal_notes": null,
      "billing_method": "Hourly Project Rate",
      "fixed_price_project": false,
      "hourly_person_rate": false,
      "hourly_task_rate": false,
      "hourly_project_rate": true,
      "client": {
        "id": "3f0c0f87-ddc7-45f4-ad7a-c3690fa04963",
        "identifier": "7c1f5e2a9b",
        "name": "Acme Corp",
        "currency": "USD",
        "status": "active",
        "internal_notes": null
      },
      "recurring_invoice": {
        "id": "6be815a8-9a10-455c-95d9-b0b548664420",
        "enabled": false,
        "first_issue_date": null,
        "frequency": null,
        "frequency_type": null,
        "time_to_send": null,
        "timezone": null,
        "interval": null
      },
      "invoice_count": 3
    },
    "tasks": [
      {
        "id": "24e6a2fe-31bb-686c-541a-9f36af3c9ecf",
        "name": "Design",
        "hourly_rate": null,
        "hourly_rate_with_currency": null,
        "deleted": false,
        "is_billable": true
      }
    ],
    "checklists": []
  },
  "breadcrumbs": [
    {
      "label": "Project users",
      "command": "neetoinvoice project-users list --project <project-id>"
    },
    {
      "label": "Update",
      "command": "neetoinvoice projects update <project-id> --user-email <email>"
    }
  ]
}

Create a project

Create a project under a client. At least one --task is required, because a project must always have a task to log time against.

neetoinvoice projects create \
  --name "Website Redesign" \
  --client-id 3f0c0f87-ddc7-45f4-ad7a-c3690fa04963 \
  --task Design \
  --task Development \
  --billing-method hourly_project_rate \
  --hourly-rate 120 \
  --currency USD \
  --user-email oliver@example.com

Flag	Type	Required	Default	Description
`--billing-method`	`string`	No		Billing method (hourly_project_rate, hourly_person_rate, hourly_task_rate, fixed_price_project)
`--client-id`	`string`	Yes		Client record ID (UUID) the project belongs to
`--currency`	`string`	No		Currency code (e.g. USD)
`--flat-amount`	`float64`	No	`0`	Flat amount (for fixed price projects)
`--hourly-rate`	`float64`	No	`0`	Hourly rate
`--internal-notes`	`string`	No		Internal notes
`--name`	`string`	Yes		Project name
`--task`	`stringSlice`	Yes	`[]`	Task name to add to the project (repeatable; at least one task is required on create)
`--user-email`	`string`	Yes		Email of the acting organization user

Billing methods are hourly_project_rate, hourly_person_rate, hourly_task_rate, and fixed_price_project. Use --flat-amount instead of --hourly-rate for a fixed price project.

Sample output (--json)

{
  "data": {
    "notice_code": "thumbs_up",
    "project": {
      "id": "f627c399-379d-4d07-a6f6-90b7c9470ac0",
      "identifier": "89d1b47d9f36af3c9ecf",
      "name": "Website Redesign",
      "client_id": "3f0c0f87-ddc7-45f4-ad7a-c3690fa04963",
      "status": "active"
    }
  },
  "breadcrumbs": [
    { "label": "Show", "command": "neetoinvoice projects show <project-id>" },
    {
      "label": "Add user",
      "command": "neetoinvoice project-users create --project <project-id> --user-id <user-id>"
    }
  ]
}

Update a project

Update a project. Only the flags you pass are changed. --user-email identifies the acting organization user and is always required.

neetoinvoice projects update 89d1b47d9f36af3c9ecf \
  --hourly-rate 140 \
  --user-email oliver@example.com

Required arguments:

<project-id> - The project’s identifier.

Flag	Type	Required	Default	Description
`--billing-method`	`string`	No		Billing method (hourly_project_rate, hourly_person_rate, hourly_task_rate, fixed_price_project)
`--client-id`	`string`	No		Client record ID (UUID) the project belongs to
`--currency`	`string`	No		Currency code (e.g. USD)
`--flat-amount`	`float64`	No	`0`	Flat amount (for fixed price projects)
`--hourly-rate`	`float64`	No	`0`	Hourly rate
`--internal-notes`	`string`	No		Internal notes
`--name`	`string`	No		Project name
`--task`	`stringSlice`	No	`[]`	Task name to add to the project (repeatable; at least one task is required on create)
`--user-email`	`string`	Yes		Email of the acting organization user

Getting started

Commands

List projects

Show a project

Create a project

Update a project

​List projects

​Show a project

​Create a project

​Update a project

List projects

Show a project

Create a project

Update a project