Owner Claim

Confirm an owner claim

Finalizes an owner claim: links owner.auth_user_id to the currently authenticated account and marks the claim session as consumed.

Authentication

Unlike the GET above, this endpoint requires authentication (Bearer JWT, properties:read permission). The user must be logged in; the confirmation matches the authenticated account against the claim initiator. The token is still read from the URL path.

Body

The request body may be empty: the confirmation is derived from the JWT and the path token.

Example

curl -X POST https://api.faireplace.com/api/owner-claim/3f8b1c2d-...-9a0e/confirm \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Response:

{
  "owner_id": "550e8400-e29b-41d4-a716-446655440000",
  "claimed_at": "2026-06-20T14:30:00Z"
}
post/owner-claim/{token}/confirm

Request

  • Base URL: https://api.faireplace.com/api
  • URL: https://api.faireplace.com/api/owner-claim/{token}/confirm
  • Auth: HTTP bearer

Path parameters

tokenstring required

Owner claim token (clear value from the email link).

Request body

ConfirmOwnerClaimBody required

Body for the confirm endpoint. An empty body is accepted: the confirmation is derived from the authenticated JWT and the token in the path. The optional field exists only to allow forward-compatible extension (e.g. consent flags).

Response

Claim confirmed and linked to the authenticated account.

owner_idstring uuid required

Identifier of the owner that is now linked to the authenticated account.

claimed_atstring date-time required

Timestamp at which the claim was confirmed.

Example response

{
  "owner_id": "550e8400-e29b-41d4-a716-446655440000",
  "claimed_at": "2026-06-20T14:30:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.