Update Record

To update the existing record you should know the record ID and use a PUT request with application/json or application/x-www-form-urlencoded content type of PUT/POST body. Received values will be casted according to the class defined in QuickBlox Dashboard.

A field that is present in class but not specified in the PUT request has a null value. To nullify the existing value you should specify null for application/x-www-/form-urlencoded, and null for application/json content type.

An update request updates specified fields only (i.e. other fields will be left untouched). For numeric fields Integer and Float, there is a special increment operator inc that increments or decrements the numeric field.

Recipes
Update record
Open Recipe
Add/remove value from record array
Open Recipe
Update record array element by index
Open Recipe
Increment/append value of record array
Open Recipe

Update operators

The request can contain next update operators:

Operator

Description

inc

Types: integer, float

Example:
inc[field1]=1000

Increment field <field_name> to a specified value. The value can be positive or negative (i.e. decrement operation).

pull

Types: arrays

Example:
pull[field1]=val1

Removes a specified value from the array field.

pull with filter

Types: arrays

Example:
pull[field1][<filter_operator>]=<filter_value>

Removes all elements filtered by filter operator from the array.

pull_all

Types: arrays

Example:
pull_all[field1][]=val1&pull_all[field1][]=val2

Removes all specified values from the array.

pop

Types: arrays

Example:
pop[field1]=1

Removes the last element from the array. To remove the first, the element value should be equal to 1.

push

Types: arrays

Example:
push[field1][]=val1&push[field1][]=val2

Appends specified values to the array.

add_to_set

Types: arrays

Example:
add_to_set[<field_name>]=

Adds a value to the array only if the value is not in the array already.

Update array element by index operator

Type: arrays

Example:
<field_name>[<index>]=val

Update the array element by index.

Search operators

The request can contain all, some or none of the next search operators:

Operator

Description

lt

Less Than operator

Types:integer, float

Example:
score_value[lt]=1000

lte

Less Than or Equal to operator

Types: integer, float

Example:
score_value[lte]=850

gt

Greater Than operator

Types: integer, float

Example:
bonus_count[gt]=2.45

gte

Greater Than or Equal to operator

Types: integer, float

Example:
bonus_count[gte]=56.443

ne

Not Equal to operator

Types: integer, float, string, boolean

Example:
game_mode_name[ne]=ctf

in

Contained IN array operator

Types: integer, float, string

Example:
game_mode_name[in]=deathmatch,rage

nin

Not contained IN array operator

Types: integer, float, string

Example:
game_mode_name[nin]=survivor,crazy_nightmare

all

ALL contained IN array operator

Types: array

Example:
game_modes[all]=survivo,crazy

or

OR operator

Types: integer, float, string

Example:
name[or]=sam,tim
name[or]=sam&lastname[or]=johnson

Will return records with name sam or tim.

Will return records with name sam or last name johnson.

ctn

Contains substring operator

Types: string

Example:
username[ctn]=son

Will return all records where username field contains son substring.

near

Types: location

Example:
mylocation[near]=25.32,44.551;1000

Search records in a specific radius with the current position in meters. Format: {field_name}[near]=longitude,latitude;radius.

Language