Skip to content

User

User registration, email verification, invites, and profile.

Endpoints

EndpointArgumentsReturns
v2.user.invite.acceptunknownunknown
v2.user.invite.declineunknownunknown
v2.user.invite.list-any[]
v2.user.invite.registeroptions, InviteKeyunknown
v2.user.profileuserIdunknown
v2.user.registeroptions, options, unknownobject
v2.user.registerAppleoptions, optionsobject
v2.user.registerGoogleunknown, optionsobject
v2.user.send_verification_email-unknown
v2.user.settings.global.setoptionsboolean
v2.user.verify_emailunknown, unknownunknown

v2.user.invite.accept

Description

Undocumented

This endpoint has no description in the source yet.

Parameters

Argument 1 (string, required): Invite key

Example

javascript
const { Client } = require('@hailer/cli');

const client = await Client.create({
  host: 'https://api.hailer.com',
  username: 'you@example.com',
  password: '••••••',
});

const result = await client.request('v2.user.invite.accept', [
  'string', // Invite key (required)
]);
console.log(result);

Returns

Undocumented

The return value is not described in the source yet.

Auth: callable without authentication.

Errors: on failure returns the standard Hailer error object { code, msg, details?, debug? }.

v2.user.invite.decline

Description

Undocumented

This endpoint has no description in the source yet.

Parameters

Argument 1 (string, required):

Example

javascript
const { Client } = require('@hailer/cli');

const client = await Client.create({
  host: 'https://api.hailer.com',
  username: 'you@example.com',
  password: '••••••',
});

const result = await client.request('v2.user.invite.decline', [
  'string', // argument 1 (required)
]);
console.log(result);

Returns

Undocumented

The return value is not described in the source yet.

Auth: callable without authentication.

Errors: on failure returns the standard Hailer error object { code, msg, details?, debug? }.

v2.user.invite.list

Description

Undocumented

This endpoint has no description in the source yet.

Parameters

Undocumented

This endpoint declares no argument schema in the source yet.

Example

javascript
const { Client } = require('@hailer/cli');

const client = await Client.create({
  host: 'https://api.hailer.com',
  username: 'you@example.com',
  password: '••••••',
});

const result = await client.request('v2.user.invite.list', []);
console.log(result);

Returns

Array of any.

Auth: requires an authenticated session.

Errors: on failure returns the standard Hailer error object { code, msg, details?, debug? }.

v2.user.invite.register

Description

Undocumented

This endpoint has no description in the source yet.

Parameters

Argument 1 (object, optional):

FieldTypeRequiredDescription
firstnamestringyes
lastnamestringyes
passwordstringyes

Argument 2 (InviteKey, string, required):

Example

javascript
const { Client } = require('@hailer/cli');

const client = await Client.create({
  host: 'https://api.hailer.com',
  username: 'you@example.com',
  password: '••••••',
});

const result = await client.request('v2.user.invite.register', [
  {
    firstname: 'string',
    lastname: 'string',
    password: 'string',
  },
  'string', // InviteKey (required)
]);
console.log(result);

Returns

Undocumented

The return value is not described in the source yet.

Auth: callable without authentication.

Errors: on failure returns the standard Hailer error object { code, msg, details?, debug? }.

v2.user.profile

Description

Undocumented

This endpoint has no description in the source yet.

Parameters

Argument 1 (userId, required): userId

Example

javascript
const { Client } = require('@hailer/cli');

const client = await Client.create({
  host: 'https://api.hailer.com',
  username: 'you@example.com',
  password: '••••••',
});

const result = await client.request('v2.user.profile', [
  '507f1f77bcf86cd799439011', // userId (required)
]);
console.log(result);

Returns

Undocumented

The return value is not described in the source yet.

Auth: requires an authenticated session.

Errors: on failure returns the standard Hailer error object { code, msg, details?, debug? }.

v2.user.register

Description

Undocumented

This endpoint has no description in the source yet.

Parameters

Argument 1 (object, optional):

FieldTypeRequiredDescription
emailstringyes
firstnamestringyes
lastnamestringyes
passwordstringyes

Argument 2 (object, optional):

FieldTypeRequiredDescription
copyNetworkIdWorkspaceIdnoworkspaceId (former networkId)
referralCodestringno
publicChatSessionIdstringno
viewedSlidesstringno

Argument 3 (string, optional):

Example

javascript
const { Client } = require('@hailer/cli');

const client = await Client.create({
  host: 'https://api.hailer.com',
  username: 'you@example.com',
  password: '••••••',
});

const result = await client.request('v2.user.register', [
  {
    email: 'string',
    firstname: 'string',
    lastname: 'string',
    password: 'string',
  },
  {
    copyNetworkId: '507f1f77bcf86cd799439011', // workspaceId (former networkId)
    referralCode: 'string',
  },
  'string', // argument 3
]);
console.log(result);

Returns

FieldTypeRequiredDescription
uidObjectIdyes
cidObjectIdyes

Auth: callable without authentication.

Errors: on failure returns the standard Hailer error object { code, msg, details?, debug? }.

v2.user.registerApple

Description

Register with Apple SSO.

Parameters

Argument 1 (object, required):

FieldTypeRequiredDescription
tokenstringyesidToken
emailstringyesEmail
firstnamestringyesFirstname
lastnamestringyesLastname

Argument 2 (object, optional):

FieldTypeRequiredDescription
copyNetworkIdWorkspaceIdnoworkspaceId (former networkId)
referralCodestringno

Example

javascript
const { Client } = require('@hailer/cli');

const client = await Client.create({
  host: 'https://api.hailer.com',
  username: 'you@example.com',
  password: '••••••',
});

const result = await client.request('v2.user.registerApple', [
  {
    token: 'string', // idToken
    email: 'string', // Email
    firstname: 'string', // Firstname
    lastname: 'string', // Lastname
  },
  {
    copyNetworkId: '507f1f77bcf86cd799439011', // workspaceId (former networkId)
    referralCode: 'string',
  },
]);
console.log(result);

Returns

FieldTypeRequiredDescription
uidObjectIdyes
cidObjectIdyes

Auth: callable without authentication.

Errors: on failure returns the standard Hailer error object { code, msg, details?, debug? }.

v2.user.registerGoogle

Description

Register with Google SSO.

Parameters

Argument 1 (string, required): idToken

Argument 2 (object, optional):

FieldTypeRequiredDescription
copyNetworkIdWorkspaceIdnoworkspaceId (former networkId)
referralCodestringno

Example

javascript
const { Client } = require('@hailer/cli');

const client = await Client.create({
  host: 'https://api.hailer.com',
  username: 'you@example.com',
  password: '••••••',
});

const result = await client.request('v2.user.registerGoogle', [
  'string', // idToken (required)
  {
    copyNetworkId: '507f1f77bcf86cd799439011', // workspaceId (former networkId)
    referralCode: 'string',
  },
]);
console.log(result);

Returns

FieldTypeRequiredDescription
uidObjectIdyes
cidObjectIdyes

Auth: callable without authentication.

Errors: on failure returns the standard Hailer error object { code, msg, details?, debug? }.

v2.user.send_verification_email

Description

Undocumented

This endpoint has no description in the source yet.

Parameters

Undocumented

This endpoint declares no argument schema in the source yet.

Example

javascript
const { Client } = require('@hailer/cli');

const client = await Client.create({
  host: 'https://api.hailer.com',
  username: 'you@example.com',
  password: '••••••',
});

const result = await client.request('v2.user.send_verification_email', []);
console.log(result);

Returns

Undocumented

The return value is not described in the source yet.

Auth: requires an authenticated session.

Errors: on failure returns the standard Hailer error object { code, msg, details?, debug? }.

v2.user.settings.global.set

Description

Set user's global settings

Parameters

Argument 1 (object, required):

FieldTypeRequiredDescription
enterToSendbooleanno
discussionMessageEmailbooleanno
feedPostEmailbooleanno
themestringno
hiddenFeedPostsObjectId[]no
feedSelectedWorkspacesWorkspaceId[]no
pushOnMentionbooleanno
navOnboardingSeenbooleanno
defaultViewobjectno

Example

javascript
const { Client } = require('@hailer/cli');

const client = await Client.create({
  host: 'https://api.hailer.com',
  username: 'you@example.com',
  password: '••••••',
});

const result = await client.request('v2.user.settings.global.set', [
  {
    enterToSend: false,
    discussionMessageEmail: false,
  },
]);
console.log(result);

Returns

boolean

Auth: requires an authenticated session.

Errors: on failure returns the standard Hailer error object { code, msg, details?, debug? }.

v2.user.verify_email

Description

Undocumented

This endpoint has no description in the source yet.

Parameters

Argument 1 (string, required):

Argument 2 (string, required):

Example

javascript
const { Client } = require('@hailer/cli');

const client = await Client.create({
  host: 'https://api.hailer.com',
  username: 'you@example.com',
  password: '••••••',
});

const result = await client.request('v2.user.verify_email', [
  'string', // argument 1 (required)
  'string', // argument 2 (required)
]);
console.log(result);

Returns

Undocumented

The return value is not described in the source yet.

Auth: callable without authentication.

Errors: on failure returns the standard Hailer error object { code, msg, details?, debug? }.

Hailer Developer Documentation