---
title: "Claim Guest data onto a Registered User"
description: "Browser transition that moves Guest Transcripts and Chats onto the Clerk Registered User. Requires both a Clerk Bearer token and the Guest session cookie"
canonical: "https://verbafy.io/docs/api/auth/claim-guest-session"
last-updated: "2026-10-04"
---

# Claim Guest data onto a Registered User

Browser transition that moves Guest Transcripts and Chats onto the Clerk Registered User. Requires both a Clerk Bearer token and the Guest session cookie. Agents should not call this route.

`POST /api/v1/auth/guest-sessions/claim`

OpenAPI operation `claimGuestSession`. This browser transition requires both a Clerk session JWT (`Authorization: Bearer {jwt}`) and the `verbafy_guest_session` cookie. The browser sends the HttpOnly cookie automatically. Agents should not call this route. Machine-readable contract: [OpenAPI](/openapi.json).

## curl

```curl
curl -X POST 'https://verbafy.io/api/v1/auth/guest-sessions/claim' \
  -H 'Authorization: Bearer {jwt}' \
  -H 'Cookie: verbafy_guest_session={guest_token}'
```

## JavaScript

```javascript
const response = await fetch('https://verbafy.io/api/v1/auth/guest-sessions/claim', {
  method: 'POST',
  credentials: 'include',
  headers: {
    Authorization: 'Bearer {jwt}',
  }
});
```

## Python

```python
import httpx

response = httpx.post(
    "https://verbafy.io/api/v1/auth/guest-sessions/claim",
    headers={"Authorization":"Bearer {jwt}","Cookie":"verbafy_guest_session={guest_token}"},
)
```

## Responses

| Status | Description |
| --- | --- |
| `200` | Claim result |
| `401` | Missing or invalid Clerk Bearer token or guest session |
| `409` | Conflict with current resource state |

```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "@id": "https://verbafy.io/#organization",
      "name": "Verbafy",
      "url": "https://verbafy.io",
      "logo": {
        "@type": "ImageObject",
        "url": "https://verbafy.io/opengraph-image.png"
      },
      "knowsAbout": [
        "YouTube transcription",
        "Spotify episode transcription",
        "Meeting recording transcription",
        "Speaker diarization",
        "Transcript export"
      ],
      "hasOfferCatalog": {
        "@type": "OfferCatalog",
        "@id": "https://verbafy.io/pricing#offers"
      },
      "contactPoint": {
        "@type": "ContactPoint",
        "contactType": "customer support",
        "email": "support@verbafy.io",
        "url": "https://verbafy.io/contact"
      }
    },
    {
      "@type": "WebSite",
      "@id": "https://verbafy.io/#website",
      "url": "https://verbafy.io",
      "name": "Verbafy",
      "inLanguage": "en",
      "publisher": {
        "@id": "https://verbafy.io/#organization"
      }
    },
    {
      "@type": "TechArticle",
      "@id": "https://verbafy.io/docs/api/auth/claim-guest-session#page",
      "name": "Claim Guest data onto a Registered User",
      "description": "Browser transition that moves Guest Transcripts and Chats onto the Clerk Registered User. Requires both a Clerk Bearer token and the Guest session cookie",
      "url": "https://verbafy.io/docs/api/auth/claim-guest-session",
      "image": "https://verbafy.io/opengraph-image.png",
      "datePublished": "2026-09-09",
      "dateModified": "2026-10-04",
      "inLanguage": "en",
      "author": {
        "@type": "Organization",
        "@id": "https://verbafy.io/#organization",
        "name": "Verbafy"
      },
      "isPartOf": {
        "@id": "https://verbafy.io/#website"
      },
      "publisher": {
        "@id": "https://verbafy.io/#organization"
      }
    },
    {
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "name": "Home",
          "item": "https://verbafy.io"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "name": "Claim Guest data onto a Registered User",
          "item": "https://verbafy.io/docs/api/auth/claim-guest-session"
        }
      ]
    }
  ]
}
```
