auth

Sync a Clerk session to a Framelane workspace

Verify a Clerk session token and create, adopt or return the workspace for that Clerk user. On first login a Workspace and initial API key are created and the plaintext key is returned once. If an email-signup workspace already exists for the verified Clerk primary email it is adopted instead, keeping its projects, billing and verified keys. Subsequent logins return the workspace without exposing a key.

post/v1/auth/sync

Request

Base URL: https://api.framelane.io
URL: https://api.framelane.io/v1/auth/sync
Auth: none declared

Request body

clerk_tokenstring required

Response

Successful Response

is_newboolean required

Example response

{
  "workspace": {
    "id": "ws_01J8QR2K5VKDGN2T4FBM3CZYX8",
    "name": "Acme Corp",
    "email": "dev@acmecorp.com"
  },
  "api_key": {
    "id": "key_01J8QR2K5VKDGN2T4FBM3CZYX9",
    "name": "production",
    "key_prefix": "fl_live_k",
    "key": "fl_live_kT9uQw..."
  }
}

Changes

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