---
title: "Claim an unclaimed app for the authenticated user"
method: POST
path: "/app/{id}/claim"
---

# Claim an unclaimed app for the authenticated user

`POST /app/{id}/claim`

## Request

- Base URL: `https://charm.ing`
- URL: `https://charm.ing/app/{id}/claim`
- Auth: HTTP bearer

Body must include the app’s `chrm_app_*` token. On success, ownership transfers and a bound pairing (if any) is auto-approved.

## Request body

- object
  - `token` string, required

## Response `200`

Claimed

- AppClaimResponse: Acknowledgement returned by POST /app/{id}/claim once ownership transfers.
  - `ok` true, required
  - `id` string, uuid, required
  - `manifestId` string, required
  - `claimedAt` string, date-time, required

## Other responses

- `400`: Body is not JSON or is missing `token`.
- `401`: User-scoped auth required.
- `404`: App not found.
- `409`: Already claimed by someone (possibly the caller).

---

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