Users

A user is a member of your NeetoAuth workspace. For fields and response details, see the API reference.

List users

This command shows active members of your workspace. Use this when you want to see who already has access before inviting or removing someone.

neetoauth users list
neetoauth users list --page 2 --page-size 50

Flag	Type	Required	Default	Description
`--page`	`int`		`0`	Page number
`--page-size`	`int`		`0`	Items per page (max 100)

Sample output (--json)

{
  "data": [
    {
      "email": "oliver@example.com",
      "role": "owner",
      "first_name": "Oliver",
      "last_name": "Smith"
    },
    {
      "email": "sam@example.com",
      "role": "non_owner",
      "first_name": "Sam",
      "last_name": "Smith"
    }
  ],
  "breadcrumbs": [
    { "label": "Invite a new member", "command": "neetoauth users create --email <email> --role <role>" },
    { "label": "Remove a member", "command": "neetoauth users delete <email>" }
  ],
  "pagination": {
    "total_records": 2,
    "total_pages": 1,
    "current_page_number": 1,
    "page_size": 30
  }
}

Deactivated members are left out. role is the organization-level role, either owner or non_owner; product roles are not included in this listing.

Create a user

This command invites someone to your workspace and emails them an invitation. Use this when you want to onboard a colleague, optionally granting them roles in specific neeto products at the same time.

neetoauth users create \
  --email sam@example.com \
  --role non_owner \
  --first-name Sam \
  --last-name Smith \
  --app Cal:Admin

Flag	Type	Required	Default	Description
`--app`	`stringSlice`		`[]`	Per-app role assignment as name:role (repeatable)
`--email`	`string`	Yes		Member email address
`--first-name`	`string`			Member first name
`--json-file`	`string`			Path to a JSON file with the full user payload
`--last-name`	`string`			Member last name
`--role`	`string`	Yes		Organization role, e.g. owner or non_owner

--role is the organization role and must be owner or non_owner. --app takes a name:role pair and is repeatable, so pass it once per product. Run neetoauth products list first to see which products and roles exist in the workspace. Names are matched without regard to case, so --app cal:admin works too, and the response reports the canonical names. If --first-name or --last-name is omitted, the server stores -.

Sample output (--json)

{
  "data": {
    "email": "sam@example.com",
    "role": "non_owner",
    "first_name": "Sam",
    "last_name": "Smith",
    "apps": [
      { "name": "Cal", "role": "Admin" }
    ]
  },
  "breadcrumbs": [
    { "label": "List members", "command": "neetoauth users list" },
    { "label": "Remove this member", "command": "neetoauth users delete sam@example.com" }
  ]
}

The apps array reports the product grants the server resolved, which is how you confirm a --app pair was accepted. --json-file reads the whole payload from disk, which is useful when the product grants are long or generated by a script. Flags passed on the command line override values in the file.

neetoauth users create --json-file ./new-member.json

The file holds the user object, either bare or wrapped in a user key:

new-member.json

{
  "user": {
    "email": "sam@example.com",
    "role": "non_owner",
    "first_name": "Sam",
    "last_name": "Smith",
    "apps": [
      { "name": "Cal", "role": "Admin" },
      { "name": "Desk", "role": "Agent" }
    ]
  }
}

Delete a user

This command removes a member from your workspace. Use this when someone has left or should no longer have access.

neetoauth users delete sam@example.com

Required arguments:

<email> - the exact email address of an active member

Sample output

Removed sam@example.com from the workspace.

Deactivating a member also ends their sessions across every neeto product. It is reversible only through the NeetoAuth admin UI. The command fails if the address does not match an active member, or if removing them would leave the workspace without an owner.

Getting started

Commands

List users

Create a user

Delete a user

​List users

​Create a user

​Delete a user

List users

Create a user

Delete a user