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.

Find more examples of the request by clicking the dropdown "v" button next to the "UPDATE RECORD" request title here 👉

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