Skip to content

User

Users can own records in ving. Users have privileges to access various types of data and store login credentials.

Filters

PropQueryableQualifierRange
createdAtNoYesYes
updatedAtNoNoYes
usernameYesNoNo
emailYesNoNo
realNameYesNoNo
adminNoYesNo
developerNoYesNo

Relationships

NameRecordTypeEndpoint
apikeysAPIKeyChild/api/v1/user/:id/apikeys
avatarS3FileChild/api/v1/user/:id/avatar

Endpoints

List

GET /api/v1/user

Create

POST /api/v1/user

{
    "username" : "adufresne",
    "realName" : "Andy Dufresne",
    "password" : "rock hammer",
    "email" : "andy@shawshank.prison"
}

Read

GET /api/v1/user/:id

Update

PUT /api/v1/user/:id

{
    "useAsDisplayName" : "realName"
}

Delete

DELETE /api/v1/user/:id

Options

GET /api/v1/user/options

Who Am I?

Returns a user record for the currently logged in user based upon the session passed.

GET /api/v1/user/whoami
Cookie: vingSessionId=xxx

Import Avatar

Attach an uploaded S3File to this user as an avatar.

PUT /api/v1/user/:id/import-avatar
Cookie: vingSessionId=xxx

{
    "s3FileId" : "xxx",
}