> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.neetoinvoice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# project-users

> Add, list, update, and remove the users assigned to a project.

Project users are the organization members assigned to a project. Only an assigned user can
log time against it. For fields and response details, see the
[API reference](/api-reference/project-users/list).

Every command here takes `--project <project-identifier>`. Roles are `regular_user` and
`project_manager`.

<Note>
  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](/cli/output-formats).
</Note>

## project-users list

List the users on a project. Use it to find the `project-user-id` that `update` and `delete`
need.

```bash theme={"system"}
neetoinvoice project-users list --project 89d1b47d9f36af3c9ecf
```

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

```json theme={"system"}
{
  "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"
    }
  ],
  "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>"
    }
  ]
}
```

## project-users create

Add a user to a project. `--user-id` is the organization user's record ID, not their email;
see [Getting the user ID](/getting-started/getting-user-id).

```bash theme={"system"}
neetoinvoice project-users create \
  --project 89d1b47d9f36af3c9ecf \
  --user-id 128c1dfc-b29f-4fda-9a05-8a90e197b81b \
  --role project_manager \
  --hourly-rate 120
```

| 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-id`     | `string`  | Yes      |         | User ID to add                        |

```json theme={"system"}
{
  "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>"
    }
  ]
}
```

## project-users update

Change a project user's role or hourly rate.

```bash theme={"system"}
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) |

## project-users delete

Remove a user from a project.

```bash theme={"system"}
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 |

```
Project user removed.
```