#44954 API design: Custom host vitals

[rachaelshaw]

Still TODO: "Update host's custom host vital value" endpoint

[nulmete]

Let me know what you think about my suggestions below.

Also, in order to list the custom host vitals for a particular host, I suggest extending the current host details endpoint (GET api/latest/fleet/hosts/:hostId) with a new custom_host_vitals property. (Implementation detail, no need to include a change here I think.)

[nulmete]

This should probably be

PUT /hosts/:host_id/custom_host_vitals/:id

Body:

{
  "value": "ABC-1234"
}

Default response:

Status: 200

{
  "host_id": 42,
  "custom_host_vital_id": 123,
  "name": "Asset tag",
  "value": "ABC-1234",
  "updated_at": "2026-07-01T15:23:57Z"
}

[lucasmrod]

LGTM. Just a nit comment.

[lucasmrod]

Nit:

Suggested change

	| name | string | body | **Required.** The desired variable name, without the `FLEET_SECRET_` prefix. |
	| name | string | body | **Required.** The desired variable name, without the `FLEET_HOST_VITAL_` prefix. |

[lucasmrod]

"Clearing" a host's custom vital is about PUTing with "value": "", right?