GuidesAPI ReferenceChangelogDiscussions
Log In
API Reference

Modify an address

  • Permission: ADDRESS_MANAGEMENT
  • Roles: extended_user, flex_management

Patches address details. Only the fields present in the body are changed, including within location, appliances and terms — send {"location":{"city":"Utrecht"}} and the street, postal code and house number are preserved. realm cannot be changed: it is a tenant boundary, and moving an address between tenants would take its devices, readings and access grants with it.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

UUID of the address

Body Params
location
object
appliances
object
terms
object
string

Free-form contract type recorded for this address

Responses

400

Invalid address details

403

Forbidden — the caller's role lacks the required permission (ADDRESS_MANAGEMENT).

404

Address not found

502

The address service is unavailable or timed out. error is SERVICE_UNAVAILABLE.

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json