---
title: "Update User's Iotum Host"
method: PUT
path: "/domains/{domain}/users/{user}/host"
tags: ["Meetings/Iotum", "Iotum"]
---

# Update User's Iotum Host

`PUT /domains/{domain}/users/{user}/host`

## Request

- Base URL: `https://ns-api.com/ns-api/v2`
- URL: `https://ns-api.com/ns-api/v2/domains/{domain}/users/{user}/host`
- Auth: HTTP bearer

Update a user's Iotum Host.

## Path parameters

- `domain` string, required: This is the main organization name. This is used to link resource to its group/tenant/organization/enterprise. Then using in path for GET you can set to "~" to use the domain name linked to your token/key instead of the domain name itself when reading for your own domain.
- `user` string, required: This is the main user extension for the user account. ~ can be used to mean "my account" which will extract the user from the token/key used for authentication.

## Request body

- object
  - `default-plan` string, required
  - `plans` string[], required
  - `default-addons` string[], required
  - `add-ons` string[], required
  - `iotum_time_format` object, required
    - `hm_separator` string, required
    - `md_format` string, required
    - `md_y_comma` boolean, required
    - `time_24hr` boolean, required

## Response `202`

- object
  - `code` integer, required
  - `message` string, required

## Other responses

- `409`

## Changes

- **2026-11-03** `bce16087d479`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ns-api/apis/netsapiens-api-v2/changes/domains/:domain/users/:user/host/put.md)

---

[API](https://skmtc.dev/ns-api/apis/netsapiens-api-v2.md) - [All operations](https://skmtc.dev/ns-api/apis/netsapiens-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/ns-api/apis/netsapiens-api-v2/revisions/bce16087d479?raw)