---
title: "Post User States"
method: POST
path: "/user_states"
tags: ["user-states"]
---

# Post User States

`POST /user_states`

## Query parameters

- `user_id` string, nullable

## Headers

- `x-app-version` string, nullable
- `x-home-trigger` string, nullable
- `accept-language` string, nullable
- `x-device-timezone` string, nullable
- `x-units` string, nullable

## Request body

- StateCreateRequest — Request schema for creating/updating user state.
  - `latitude` number, nullable
  - `longitude` number, nullable
  - `timezone` string, nullable
  - `now_iso` string, date-time, nullable
  - `feedback` string, nullable
  - `notification_id` string, nullable
  - `notification_action` string, nullable — 'reply' (default) for text/voice input, or 'button_1'/'button_2'/'button_3' for quick-reply chip taps.
  - `notification_label` string, nullable — The chip label that was tapped (null for replies).

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/imperfect/apis/imperfect-api.md) · [All operations](https://skmtc.dev/imperfect/apis/imperfect-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/imperfect/imperfect-api/revisions/55d56c4beab4/schema)