POST /api/service/identity/set/
Update identity fields other than the device private key and save them to EEPROM.
Auth: Bearer (powerUser).
Request
Section titled “Request”The request body must be a JSON object without an additional identity wrapper.
{ "urlAutoConfig": "https://example.invalid", "manufacturer": "Novatek", "pinCode": "123456"}Request fields
Section titled “Request fields”| Field | Type | Required | Description |
|---|---|---|---|
urlAutoConfig | string | no | Auto-configuration URL |
manufacturer | string | no | Manufacturer string |
pinCode | string | no | PIN code |
Length limits:
urlAutoConfig: up to63characters.manufacturer: up to23characters.pinCode: up to11characters.
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.
Response 200
Section titled “Response 200”{}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.