ASaspect
Projects

Add User To Project

Add a user to a project with the specified role.

If the person has no Aspect account yet, they're invited by email.

Requirements:

  • Requires FULL_ACCESS on the project
  • Cannot set project permissions for workspace owners (they always have full access)
  • If the user doesn't have workspace access, auto-creates member_limited workspace permission, which takes a seat; only a workspace admin's add can buy that seat (purchase_seat)

Role must be a valid project role: full_access, editor, commenter, downloader, viewer

post/projects/{project_id}/users

Request

  • Base URL
    https://api.aspect.inc
  • URL
    https://api.aspect.inc/projects/{project_id}/users
  • Auth
    API key in header Authorization

Path parameters

project_idstring uuid required

Request body

emailstring required

Email of the user to add to project

role'full_access' | 'editor' | 'commenter' | 'downloader' | 'viewer' | 'no_access'

Role on a project.

purchase_seatboolean

Buy a seat if none is free (prorated, charged now). Ignored when a seat is free. Only when the person is new to the workspace and you're a workspace admin.

Response

Successful Response

idstring uuid required

User ID

first_namestring required

User's first name

last_namestring required

User's last name

emailstring required

User's email address

avatar_urlstring nullable

User's avatar URL

role'full_access' | 'editor' | 'commenter' | 'downloader' | 'viewer' | 'no_access' required

Role on a project.

workspace_role'owner' | 'member' | 'member_limited' required

Role in a workspace.

has_explicit_permissionboolean required

True when the role was set on this project directly. False when it comes from the project's default role or workspace ownership.

Changes

No recorded changes to this operation across all 1 revision of this API.