OpenBroadcaster Documentation
controllers / account.php

Account

Controller

Manages everything account related. Covers logging and logging out, permissions, groups, account settings, creating new accounts, and recovering passwords. Specifically to be used by individual accounts; for managing lists of permissions, users, and groups, use the Users controller.

public  forgotpass ( )

Send message to provided email to aid in recovering account with forgotten password.

Parameters
email
API Route POST /api/v2/account/forgot
public  groups ( )

Return currently logged in user groups.

Returns group_names_array
API Route GET /api/v2/account/groups
public  key_delete ( )

Delete App Key for currently logged in user. Requires 'manage_appkeys' permission. Connects to users model.

Parameters
id
Returns is_deleted?
API Route DELETE /api/v2/account/key/(:id:)
public  key_load ( )

Load App Keys for currently logged in user. Requires 'manage_appkeys' permission. Connects to users model.

Returns appkeys
API Route GET /api/v2/account/key
public  key_new ( )

Generate a new App Key for the logged in user. Requires the 'manage_appkeys' permission. Connects to the users model.

Returns [id, name, key]
API Route POST /api/v2/account/key
public  key_permissions_save ( )

Save App Key permissions. Requires 'manage_appkeys' permission. Connects to users model.

Parameters
id
permissions
API Route PUT /api/v2/account/key/(:id:)
public  login ( )

Login using the provided username and password.

Parameters
username
password
Returns [id, key, key_expiry]
API Route POST /api/v2/account/login
public  logout ( )

Logout currently logged in user.

API Route POST /api/v2/account/logout
public  newaccount ( )

Create a new account using the provided fields if user registration is currently enabled, and all the fields are validated.

Parameters
name
email
username
API Route POST /api/v2/account/new
public  permissions ( )

Return currently logged in user permissions.

Returns permission_array
API Route GET /api/v2/account/permissions
public  settings ( )

Return userdata (except for sensitive information) for currently logged in user.

Returns user_fields_array
API Route GET /api/v2/account/settings
public  store ( )

Get or save arbitrary string data associated with the logged in account. Used for UI/client settings, etc. Only returns value when getting (not saving).

Parameters
name
value
Returns value
public  store_all ( )

Get all saved account settings.

Returns values
public  uid ( )

Return currently logged in username and user id.

Returns [id, username]
API Route GET /api/v2/account/uid
public  update_settings ( )

Update currently logged in user settings.

Parameters
name
password
password_again
email
display_name
language
theme
dyslexia_friendly_font Boolean set to TRUE for using a dyslexia-friendly font.
sidebar_display_left Boolean set to TRUE when displaying the sidebar on the left side.
API Route PUT /api/v2/account/settings