Notice: Each user has a certain role in the system. Each role determines the user’s privileges. Depending on the role, the user may not be able to list or display other users that are not “visible” to him/her.


GET /api/v1/users
Display a list of all users.

Metadata

- Authentication: The user must be authenticated to perform this action.

GET /api/v1/users/:id
Display a user.

Metadata

- Authentication: The user must be authenticated to perform this action.

Params

Param name Description
id
required

ID of the user to be displayed.

Validations:

  • Must be a String


POST /api/v1/users
Create a new user.

Metadata

- Authentication: The user must be authenticated to perform this action.
- Admin privileges: The user has to have administrative privileges to perform this
    action.

Params

Param name Description
user
optional , nil allowed

Validations:

  • Must be a Hash

user[username]
required

User’s login name.

Validations:

  • Must be a String

user[password]
optional , nil allowed

User’s password.

Validations:

  • Must be a String

user[password_confirmation]
optional , nil allowed

User’s password confirmation.

Validations:

  • Must be a String

user[role_id]
required

The string determining user’s role in the application.

Validations:

  • Must be a String

user[firstname]
optional , nil allowed

User’s first name.

Validations:

  • Must be a String

user[lastname]
optional , nil allowed

User’s last name.

Validations:

  • Must be a String

user[user_matrix_attributes]
optional , nil allowed

Capabilities of this specific user. Overrides role capabilities.

Validations:

  • Must be a Hash

user[skies_tier]
optional , nil allowed

User’s Skies tier.

Validations:

  • Must be a String

user[authentication_method]
optional , nil allowed

Optionally set the authentication method to: ldap,openid.

Validations:

  • Must be a String


POST /api/v1/users/invite
Create a new user and send them an invitation email.

Metadata

- Authentication: The user must be authenticated to perform this action.
- Admin privileges: The user has to have administrative privileges to perform this
    action.

Params

Param name Description
user
optional , nil allowed

Validations:

  • Must be a Hash

user[username]
optional

User’s login name.

Validations:

  • Must be a String

user[password]
optional , nil allowed

User’s password.

Validations:

  • Must be a String

user[password_confirmation]
optional , nil allowed

User’s password confirmation.

Validations:

  • Must be a String

user[role_id]
optional

The string determining user’s role in the application.

Validations:

  • Must be a String

user[firstname]
optional , nil allowed

User’s first name.

Validations:

  • Must be a String

user[lastname]
optional , nil allowed

User’s last name.

Validations:

  • Must be a String

user[user_matrix_attributes]
optional , nil allowed

Capabilities of this specific user. Overrides role capabilities.

Validations:

  • Must be a Hash

user[skies_tier]
optional , nil allowed

User’s Skies tier.

Validations:

  • Must be a String

user[authentication_method]
optional , nil allowed

Optionally set the authentication method to: ldap,openid.

Validations:

  • Must be a String

team_id
optional

Optionally the team to assign to the new user.

Validations:

  • Must be a String

message
optional

Optional message to attach to the invitation.

Validations:

  • Must be a String


PUT /api/v1/users/:id
Update a user.

Metadata

- Authentication: The user must be authenticated to perform this action.
- Admin privileges: The user has to have administrative privileges to perform this
    action.

Params

Param name Description
id
required

ID of the user to be updated.

Validations:

  • Must be a String

user
optional , nil allowed

Validations:

  • Must be a Hash

user[username]
optional

User’s login name.

Validations:

  • Must be a String

user[password]
optional , nil allowed

User’s password.

Validations:

  • Must be a String

user[password_confirmation]
optional , nil allowed

User’s password confirmation.

Validations:

  • Must be a String

user[role_id]
optional

The string determining user’s role in the application.

Validations:

  • Must be a String

user[firstname]
optional , nil allowed

User’s first name.

Validations:

  • Must be a String

user[lastname]
optional , nil allowed

User’s last name.

Validations:

  • Must be a String

user[user_matrix_attributes]
optional , nil allowed

Capabilities of this specific user. Overrides role capabilities.

Validations:

  • Must be a Hash

user[skies_tier]
optional , nil allowed

User’s Skies tier.

Validations:

  • Must be a String

user[authentication_method]
optional , nil allowed

Optionally set the authentication method to: ldap,openid.

Validations:

  • Must be a String


DELETE /api/v1/users/:id
Delete a user.

Metadata

- Authentication: The user must be authenticated to perform this action.
- Admin privileges: The user has to have administrative privileges to perform this
    action.

Params

Param name Description
id
required

ID of the user to be deleted.

Validations:

  • Must be a String


POST /api/v1/users/:user_id/teams/:team_id
Add a user to a team.

Metadata

- Authentication: The user must be authenticated to perform this action.
- Admin privileges: The user has to have administrative privileges to perform this
    action.

Params

Param name Description
user_id
required

ID of the user to be added to a team.

Validations:

  • Must be a String

team_id
required

ID of the team to add the user to.

Validations:

  • Must be a String


DELETE /api/v1/users/:user_id/teams/:team_id
Remove a user from a team.

Metadata

- Authentication: The user must be authenticated to perform this action.
- Admin privileges: The user has to have administrative privileges to perform this
    action.

Params

Param name Description
user_id
required

ID of the user to be removed from a team.

Validations:

  • Must be a String

team_id
required

ID of the team from which the user is to be removed.

Validations:

  • Must be a String


POST /api/v1/users/:user_id/assign_to_all_teams
Assign a user to all teams.

Metadata

- Authentication: The user must be authenticated to perform this action.
- Admin privileges: The user has to have administrative privileges to perform this
    action.

Params

Param name Description
id
required

ID of the user.

Validations:

  • Must be a String


DELETE /api/v1/users/:user_id/remove_from_all_teams
Remove a user from all teams.

Metadata

- Authentication: The user must be authenticated to perform this action.
- Admin privileges: The user has to have administrative privileges to perform this
    action.

Params

Param name Description
id
required

ID of the user.

Validations:

  • Must be a String


GET /api/v1/users/:user_id/settings
Retrieve user settings.

Metadata

Access: The user may retrieve their own user settings. For viewing someone else's
  settings, the user has to be an administrator.

PUT /api/v1/users/:user_id/settings
Update user settings.

Metadata

Access: The user may update their own user settings. To update someone else's settings,
  the user has to be an administrator.

Params

Param name Description
settings
required

Hash of the user settings. Allowed keys are [background, sync_interval, show_scanlines, proxy_seeking, thumbnail_width, disable_safe_search, build_project_name_from_custom_metadata, hide_archived_content, project_display, panel_import_method, list_display, auto_import_unmanged_media, auto_import_unmanged_media_interval, auto_link_library_media, auto_link_library_media_interval, auto_link_subproject_media, auto_link_subproject_media_interval, on_asset_double_click, timecode_position, search_tabs, asset_ordering, unsubscribe_from_assets_after, unsubscribe_from_projects_after, unsubscribe_from_galleries_after, project_session].

Validations:

  • Must be a Hash


PUT /api/v1/users/:user_id/background
Set custom user background.

Metadata

Access: The user may change their own background. To set someone else's background,
  the user has to be an administrator.