---
title: "Report device zone"
method: POST
path: "/v1/me/device-zone"
tags: ["Owner"]
---

# Report device zone

`POST /v1/me/device-zone`

## Request

- Base URL: `https://api.vicem.ai`
- URL: `https://api.vicem.ai/v1/me/device-zone`
- Auth: HTTP bearer

## Request body

- ReportDeviceZoneRequest
  - `zone` string, required
  - `platform` 'ios' | 'android' | 'web', required
  - `trigger` 'launch' | 'foreground' | 'calendar' | 'background' | 'push', required
  - `observedAt` string, date-time

## Response `200`

OK

- ReportDeviceZoneResponse
  - `effective` string, required
  - `home` string, required
  - `mode` 'follow' | 'ask' | 'fixed', required
  - `pending` string, required
  - `effectiveOffset` string, required
  - `homeOffset` string, required
  - `pendingOffset` string, nullable, required
  - `source` 'signup' | 'device' | 'owner_voice' | 'manual' | 'undo' | 'revert' | 'confirm', nullable, required
  - `changedAt` string, date-time, required
  - `until` string, date-time, required
  - `outcome` 'unchanged' | 'stored' | 'waiting_second_sighting' | 'moved' | 'asked' | 'ask_pending' | 'declined_zone' | 'back_home', required

## Other responses

- `400`: Invalid request (body not JSON, or schema validation failed).
- `401`: Missing, expired or invalid bearer token.
- `413`: Body over the limit (64 KB; 512 KB for contact import).
- `500`: Unexpected server error (reported to Sentry).

---

[API](https://skmtc.dev/vicem/apis/vicem-api.md) · [All operations](https://skmtc.dev/vicem/apis/vicem-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vicem/apis/vicem-api/revisions/9efcec07e5f4?raw)