---
title: "Decline an assistant location request from the customer's phone"
method: POST
path: "/v1/account/location-handoffs/{handoff_id}/decline-from-device"
tags: ["Customer Account"]
---

# Decline an assistant location request from the customer's phone

`POST /v1/account/location-handoffs/{handoff_id}/decline-from-device`

## Request

- Base URL: `https://loppee.com`
- URL: `https://loppee.com/v1/account/location-handoffs/{handoff_id}/decline-from-device`
- Auth: HTTP bearer

Requires the signed-in, originless Loppee iOS client plus a one-use App Attest assertion over the exact active installation, verified assistant connection, current credential, handoff, and request mode. It invalidates the request, suppresses pending delivery, clears encrypted coordinate material, and never accepts or returns coordinates.

## Path parameters

- `handoff_id` string, required

## Headers

- `X-Loppee-Client-Platform` string, required
- `X-Loppee-Installation-Id` string, required

## Request body

- object
  - `installation_id` string, uuid, required
  - `connection_id` string, uuid, required
  - `oauth_grant_id` string, uuid, nullable, required
  - `agent_key_id` string, uuid, required
  - `request_mode` 'automatic' | 'approval_required', required
  - `challenge_id` string, uuid, required
  - `challenge` string, required
  - `key_id` string, required
  - `assertion` string, required

## Response `200`

Decline an assistant location request from the customer's phone response

- object
  - `handoff_id` string, uuid, required
  - `status` 'declined', required
  - `declined` true, required
  - `agent_receives_coordinates` false, required

## Other responses

- `400`: ErrorResponse
- `401`: ErrorResponse
- `403`: ErrorResponse
- `404`: ErrorResponse
- `409`: ErrorResponse
- `413`: ErrorResponse
- `429`: RateLimitError
- `default`: ErrorResponse

---

[API](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents.md) · [All operations](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/revisions/37285f7cddcd?raw)