Project users

A project user is an organization member assigned to a project. Only an assigned user can log time against it. For fields and response details, see the API reference. Every command here takes --project <project-identifier>. Roles are regular_user and project_manager.

List project users

List the users on a project. Use it to find the project-user-id that update and delete need. 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.

neetoinvoice project-users list --project 89d1b47d9f36af3c9ecf

Flag	Type	Required	Default	Description
`--page`	`int`	No	unset	Page number
`--page-size`	`int`	No	unset	Items per page (max 100)
`--project`	`string`	Yes		Project identifier

Sample output (--json)

{
  "data": [
    {
      "id": "5a2de667-243b-4da3-b090-b698a03d98da",
      "user_id": "128c1dfc-b29f-4fda-9a05-8a90e197b81b",
      "role": "project_manager",
      "hourly_rate": 120.0,
      "name": "Oliver Smith",
      "email": "oliver@example.com"
    }
  ],
  "pagination": {
    "total_records": 1,
    "total_pages": 1,
    "current_page_number": 1,
    "page_size": 30
  },
  "breadcrumbs": [
    {
      "label": "Add user",
      "command": "neetoinvoice project-users create --project <project-id> --user-id <user-id>"
    },
    {
      "label": "Update",
      "command": "neetoinvoice project-users update <project-user-id> --project <project-id>"
    }
  ]
}

Create a project user

Add a user to a project. Identify the user with either --user-id, the organization user’s record ID (see Getting the user ID), or --user-email, the email of an active team member. Pass exactly one of them.

neetoinvoice project-users create \
  --project 89d1b47d9f36af3c9ecf \
  --user-id 128c1dfc-b29f-4fda-9a05-8a90e197b81b \
  --role project_manager \
  --hourly-rate 120

The same user, added by email:

neetoinvoice project-users create \
  --project 89d1b47d9f36af3c9ecf \
  --user-email oliver@example.com \
  --role project_manager

Flag	Type	Required	Default	Description
`--hourly-rate`	`float64`	No	`0`	Hourly rate
`--project`	`string`	Yes		Project identifier
`--role`	`string`	No		Role (regular_user/project_manager)
`--user-email`	`string`	No		Email of the team member to add (alternative to —user-id)
`--user-id`	`string`	No		User ID to add

Sample output (--json)

{
  "data": {
    "project_user": {
      "id": "5a2de667-243b-4da3-b090-b698a03d98da",
      "user_id": "128c1dfc-b29f-4fda-9a05-8a90e197b81b",
      "role": "project_manager",
      "hourly_rate": 120.0,
      "name": "Oliver Smith",
      "email": "oliver@example.com",
      "time_zone": "Asia/Kolkata"
    }
  },
  "breadcrumbs": [
    {
      "label": "List",
      "command": "neetoinvoice project-users list --project <project-id>"
    }
  ]
}

Update a project user

Change a project user’s role or hourly rate.

neetoinvoice project-users update 5a2de667-243b-4da3-b090-b698a03d98da \
  --project 89d1b47d9f36af3c9ecf \
  --hourly-rate 140

Required arguments:

<project-user-id> - The project user’s record ID, from project-users list.

Flag	Type	Required	Default	Description
`--hourly-rate`	`float64`	No	`0`	Hourly rate
`--project`	`string`	Yes		Project identifier
`--role`	`string`	No		Role (regular_user/project_manager)

Delete a project user

Remove a user from a project.

neetoinvoice project-users delete 5a2de667-243b-4da3-b090-b698a03d98da \
  --project 89d1b47d9f36af3c9ecf

Required arguments:

<project-user-id> - The project user’s record ID, from project-users list.

Flag	Type	Required	Default	Description
`--project`	`string`	Yes		Project identifier

Sample output

Project user removed.

Getting started

Commands

List project users

Create a project user

Update a project user

Delete a project user

​List project users

​Create a project user

​Update a project user

​Delete a project user

List project users

Create a project user

Update a project user

Delete a project user