---
title: "POST /v1/guest-preview-sessions/{session_id}/claim"
method: POST
path: "/v1/guest-preview-sessions/{session_id}/claim"
tags: ["Conversion"]
---

# POST /v1/guest-preview-sessions/{session_id}/claim

`POST /v1/guest-preview-sessions/{session_id}/claim`

## Request

- Base URL: `https://markovo.net`
- URL: `https://markovo.net/v1/guest-preview-sessions/{session_id}/claim`
- Auth: one of:
  - API key in cookie `better-auth.session_token` and API key in header `x-markovo-preview-token`
  - HTTP bearer and API key in header `x-markovo-preview-token`

Binds completed anonymous preview jobs to the signed-in account and settles their measured Credit cost exactly once. An insufficient balance preserves the result and queue for retry after Billing.

## Response `200`

Already settled or newly settled exactly once

- GuestPreviewClaim
  - `status` 'settled', required
  - `actual_credit_units` integer, required

## Other responses

- `401`: Machine-readable safe error
- `402`: Machine-readable safe error
- `409`: Machine-readable safe error
- `410`: Machine-readable safe error
- `503`: Machine-readable safe error

---

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