Skip to content

POST /api/service/identity/set/

Update identity fields other than the device private key and save them to EEPROM.

Auth: Bearer (powerUser).


The request body must be a JSON object without an additional identity wrapper.

{
"urlAutoConfig": "https://example.invalid",
"manufacturer": "Novatek",
"pinCode": "123456"
}
FieldTypeRequiredDescription
urlAutoConfigstringnoAuto-configuration URL
manufacturerstringnoManufacturer string
pinCodestringnoPIN code

Length limits:

  • urlAutoConfig: up to 63 characters.
  • manufacturer: up to 23 characters.
  • pinCode: up to 11 characters.

Empty body → 400 ERROR_API_PARSING.

A body that is not an object → 400 ERROR_INVALID_ARGUMENT.

If none of the supported fields are provided → 400 ERROR_INVALID_ARGUMENT.


{}

If the device private key or password has not been initialized yet, the API returns 503 ERROR_NOT_READY.

Initially populating an empty identity field is allowed without a service dongle. Changing or clearing an already populated field requires the dongle and returns an access error if it is absent. Submitting the existing value is not considered an overwrite.