Client

Used to interact with the Client Object.

Get Current Client

Returns the current client that is present either in the browser cookies or authorization header.

SecurityNone or DevBrowser

Responses

200

Returns the current session object.

400

Request was not successful

401

Request was not successful

get/v1/client

Response samples

application/json

{"client": { },
"response": {"object": "client",
"id": "string",
"sign_in": {"object": "sign_in_attempt",
"id": "string",
"status": "abandoned",
"supported_identifiers": ["email_address"
],
"identifier": "string",
"user_data": {"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true
},
"supported_first_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"default": true
}
],
"first_factor_verification": {"status": "unverified",
"strategy": "password",
"attempts": 0,
"expire_at": 0
},
"supported_second_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"default": true
}
],
"second_factor_verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"created_session_id": "string",
"abandon_at": 0
},
"sign_up": {"object": "sign_up_attempt",
"id": "string",
"status": "abandoned",
"required_fields": ["string"
],
"optional_fields": ["string"
],
"missing_fields": ["string"
],
"unverified_fields": ["string"
],
"verifications": {"email_address": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"phone_number": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"external_account": {"status": "unverified",
"strategy": "string",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
}
},
"username": "string",
"email_address": "string",
"phone_number": "string",
"web3_wallet": "string",
"password_enabled": true,
"first_name": "string",
"last_name": "string",
"unsafe_metadata": { },
"public_metadata": { },
"external_id": "string",
"created_session_id": "string",
"created_user_id": "string",
"abandon_at": 0,
"legal_accepted_at": 1700690400000
},
"sessions": [{"id": "string",
"object": "session",
"actor": { },
"status": "active",
"last_active_at": 0,
"expire_at": 0,
"abandon_at": 0,
"user": {"id": "string",
"object": "user",
"external_id": "string",
"primary_email_address_id": "string",
"primary_phone_number_id": "string",
"primary_web3_wallet_id": "string",
"username": "string",
"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"public_metadata": { },
"private_metadata": { },
"unsafe_metadata": { },
"email_addresses": [{"id": "string",
"object": "email_address",
"email_address": "string",
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"created_at": 0,
"updated_at": 0
}
],
"phone_numbers": [{"id": "string",
"object": "phone_number",
"phone_number": "string",
"reserved_for_second_factor": true,
"default_second_factor": true,
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"backup_codes": [null
],
"created_at": 0,
"updated_at": 0
}
],
"web3_wallets": [{"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null,
"message": null
},
"created_at": 0,
"updated_at": 0
}
],
"passkeys": [{"id": "string",
"object": "passkey",
"name": "string",
"last_used_at": 0,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null
},
"created_at": 0,
"updated_at": 0
}
],
"organization_memberships": [{"id": "string",
"object": "organization_membership",
"role": "string",
"created_at": 0,
"updated_at": 0,
"organization": {"id": null,
"object": null,
"name": null,
"max_allowed_memberships": null,
"admin_delete_enabled": null,
"slug": null,
"logo_url": null,
"image_url": null,
"has_image": null,
"members_count": null,
"pending_invitations_count": null,
"public_metadata": { },
"created_at": null,
"updated_at": null
},
"public_user_data": {"user_id": null,
"first_name": null,
"last_name": null,
"profile_image_url": null,
"image_url": null,
"has_image": null,
"identifier": null
}
}
],
"password_enabled": true,
"two_factor_enabled": true,
"totp_enabled": true,
"backup_code_enabled": true,
"external_accounts": [{"object": "external_account",
"id": "string",
"provider": "string",
"provider_user_id": "string",
"approved_scopes": "string",
"email_address": "string",
"first_name": "string",
"last_name": "string",
"avatar_url": "string",
"image_url": "string",
"username": "string",
"public_metadata": { },
"label": "string",
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": { },
"expire_at": null,
"attempts": null
},
"created_at": 0,
"updated_at": 0
}
],
"saml_accounts": [{"id": "string",
"object": "saml_account",
"provider": "string",
"active": true,
"email_address": "string",
"first_name": "string",
"last_name": "string",
"provider_user_id": "string",
"public_metadata": { },
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": null,
"expire_at": null,
"attempts": null
},
"saml_connection": {"id": null,
"name": null,
"domain": null,
"active": null,
"provider": null,
"sync_user_attributes": null,
"allow_subdomains": null,
"allow_idp_initiated": null,
"disable_additional_identifications": null,
"created_at": null,
"updated_at": null
}
}
],
"last_sign_in_at": 0,
"banned": true,
"locked": true,
"lockout_expires_in_seconds": 0,
"verification_attempts_remaining": 0,
"updated_at": 0,
"created_at": 0,
"delete_self_enabled": true,
"create_organization_enabled": true,
"create_organizations_limit": 0,
"last_active_at": 0,
"legal_accepted_at": 1700690400000
},
"public_user_data": {"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"identifier": "string"
}
}
],
"last_active_session_id": "string",
"updated_at": 0,
"created_at": 0
}
}

Create New Client

Creates a new Client and sets it either in the response cookies or the response authorization header.

SecurityNone or DevBrowser

Responses

200

Returns the current session object.

307

Redirect, no body.

put/v1/client

Response samples

application/json

{"client": { },
"response": {"object": "client",
"id": "string",
"sign_in": {"object": "sign_in_attempt",
"id": "string",
"status": "abandoned",
"supported_identifiers": ["email_address"
],
"identifier": "string",
"user_data": {"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true
},
"supported_first_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"default": true
}
],
"first_factor_verification": {"status": "unverified",
"strategy": "password",
"attempts": 0,
"expire_at": 0
},
"supported_second_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"default": true
}
],
"second_factor_verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"created_session_id": "string",
"abandon_at": 0
},
"sign_up": {"object": "sign_up_attempt",
"id": "string",
"status": "abandoned",
"required_fields": ["string"
],
"optional_fields": ["string"
],
"missing_fields": ["string"
],
"unverified_fields": ["string"
],
"verifications": {"email_address": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"phone_number": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"external_account": {"status": "unverified",
"strategy": "string",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
}
},
"username": "string",
"email_address": "string",
"phone_number": "string",
"web3_wallet": "string",
"password_enabled": true,
"first_name": "string",
"last_name": "string",
"unsafe_metadata": { },
"public_metadata": { },
"external_id": "string",
"created_session_id": "string",
"created_user_id": "string",
"abandon_at": 0,
"legal_accepted_at": 1700690400000
},
"sessions": [{"id": "string",
"object": "session",
"actor": { },
"status": "active",
"last_active_at": 0,
"expire_at": 0,
"abandon_at": 0,
"user": {"id": "string",
"object": "user",
"external_id": "string",
"primary_email_address_id": "string",
"primary_phone_number_id": "string",
"primary_web3_wallet_id": "string",
"username": "string",
"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"public_metadata": { },
"private_metadata": { },
"unsafe_metadata": { },
"email_addresses": [{"id": "string",
"object": "email_address",
"email_address": "string",
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"created_at": 0,
"updated_at": 0
}
],
"phone_numbers": [{"id": "string",
"object": "phone_number",
"phone_number": "string",
"reserved_for_second_factor": true,
"default_second_factor": true,
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"backup_codes": [null
],
"created_at": 0,
"updated_at": 0
}
],
"web3_wallets": [{"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null,
"message": null
},
"created_at": 0,
"updated_at": 0
}
],
"passkeys": [{"id": "string",
"object": "passkey",
"name": "string",
"last_used_at": 0,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null
},
"created_at": 0,
"updated_at": 0
}
],
"organization_memberships": [{"id": "string",
"object": "organization_membership",
"role": "string",
"created_at": 0,
"updated_at": 0,
"organization": {"id": null,
"object": null,
"name": null,
"max_allowed_memberships": null,
"admin_delete_enabled": null,
"slug": null,
"logo_url": null,
"image_url": null,
"has_image": null,
"members_count": null,
"pending_invitations_count": null,
"public_metadata": { },
"created_at": null,
"updated_at": null
},
"public_user_data": {"user_id": null,
"first_name": null,
"last_name": null,
"profile_image_url": null,
"image_url": null,
"has_image": null,
"identifier": null
}
}
],
"password_enabled": true,
"two_factor_enabled": true,
"totp_enabled": true,
"backup_code_enabled": true,
"external_accounts": [{"object": "external_account",
"id": "string",
"provider": "string",
"provider_user_id": "string",
"approved_scopes": "string",
"email_address": "string",
"first_name": "string",
"last_name": "string",
"avatar_url": "string",
"image_url": "string",
"username": "string",
"public_metadata": { },
"label": "string",
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": { },
"expire_at": null,
"attempts": null
},
"created_at": 0,
"updated_at": 0
}
],
"saml_accounts": [{"id": "string",
"object": "saml_account",
"provider": "string",
"active": true,
"email_address": "string",
"first_name": "string",
"last_name": "string",
"provider_user_id": "string",
"public_metadata": { },
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": null,
"expire_at": null,
"attempts": null
},
"saml_connection": {"id": null,
"name": null,
"domain": null,
"active": null,
"provider": null,
"sync_user_attributes": null,
"allow_subdomains": null,
"allow_idp_initiated": null,
"disable_additional_identifications": null,
"created_at": null,
"updated_at": null
}
}
],
"last_sign_in_at": 0,
"banned": true,
"locked": true,
"lockout_expires_in_seconds": 0,
"verification_attempts_remaining": 0,
"updated_at": 0,
"created_at": 0,
"delete_self_enabled": true,
"create_organization_enabled": true,
"create_organizations_limit": 0,
"last_active_at": 0,
"legal_accepted_at": 1700690400000
},
"public_user_data": {"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"identifier": "string"
}
}
],
"last_active_session_id": "string",
"updated_at": 0,
"created_at": 0
}
}

Create New Client

Creates a new Client and sets it either in the response cookies or the response authorization header.

SecurityNone or DevBrowser

Responses

200

Returns the current session object.

307

Redirect, no body.

post/v1/client

Response samples

application/json

{"client": { },
"response": {"object": "client",
"id": "string",
"sign_in": {"object": "sign_in_attempt",
"id": "string",
"status": "abandoned",
"supported_identifiers": ["email_address"
],
"identifier": "string",
"user_data": {"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true
},
"supported_first_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"default": true
}
],
"first_factor_verification": {"status": "unverified",
"strategy": "password",
"attempts": 0,
"expire_at": 0
},
"supported_second_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"default": true
}
],
"second_factor_verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"created_session_id": "string",
"abandon_at": 0
},
"sign_up": {"object": "sign_up_attempt",
"id": "string",
"status": "abandoned",
"required_fields": ["string"
],
"optional_fields": ["string"
],
"missing_fields": ["string"
],
"unverified_fields": ["string"
],
"verifications": {"email_address": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"phone_number": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"external_account": {"status": "unverified",
"strategy": "string",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
}
},
"username": "string",
"email_address": "string",
"phone_number": "string",
"web3_wallet": "string",
"password_enabled": true,
"first_name": "string",
"last_name": "string",
"unsafe_metadata": { },
"public_metadata": { },
"external_id": "string",
"created_session_id": "string",
"created_user_id": "string",
"abandon_at": 0,
"legal_accepted_at": 1700690400000
},
"sessions": [{"id": "string",
"object": "session",
"actor": { },
"status": "active",
"last_active_at": 0,
"expire_at": 0,
"abandon_at": 0,
"user": {"id": "string",
"object": "user",
"external_id": "string",
"primary_email_address_id": "string",
"primary_phone_number_id": "string",
"primary_web3_wallet_id": "string",
"username": "string",
"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"public_metadata": { },
"private_metadata": { },
"unsafe_metadata": { },
"email_addresses": [{"id": "string",
"object": "email_address",
"email_address": "string",
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"created_at": 0,
"updated_at": 0
}
],
"phone_numbers": [{"id": "string",
"object": "phone_number",
"phone_number": "string",
"reserved_for_second_factor": true,
"default_second_factor": true,
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"backup_codes": [null
],
"created_at": 0,
"updated_at": 0
}
],
"web3_wallets": [{"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null,
"message": null
},
"created_at": 0,
"updated_at": 0
}
],
"passkeys": [{"id": "string",
"object": "passkey",
"name": "string",
"last_used_at": 0,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null
},
"created_at": 0,
"updated_at": 0
}
],
"organization_memberships": [{"id": "string",
"object": "organization_membership",
"role": "string",
"created_at": 0,
"updated_at": 0,
"organization": {"id": null,
"object": null,
"name": null,
"max_allowed_memberships": null,
"admin_delete_enabled": null,
"slug": null,
"logo_url": null,
"image_url": null,
"has_image": null,
"members_count": null,
"pending_invitations_count": null,
"public_metadata": { },
"created_at": null,
"updated_at": null
},
"public_user_data": {"user_id": null,
"first_name": null,
"last_name": null,
"profile_image_url": null,
"image_url": null,
"has_image": null,
"identifier": null
}
}
],
"password_enabled": true,
"two_factor_enabled": true,
"totp_enabled": true,
"backup_code_enabled": true,
"external_accounts": [{"object": "external_account",
"id": "string",
"provider": "string",
"provider_user_id": "string",
"approved_scopes": "string",
"email_address": "string",
"first_name": "string",
"last_name": "string",
"avatar_url": "string",
"image_url": "string",
"username": "string",
"public_metadata": { },
"label": "string",
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": { },
"expire_at": null,
"attempts": null
},
"created_at": 0,
"updated_at": 0
}
],
"saml_accounts": [{"id": "string",
"object": "saml_account",
"provider": "string",
"active": true,
"email_address": "string",
"first_name": "string",
"last_name": "string",
"provider_user_id": "string",
"public_metadata": { },
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": null,
"expire_at": null,
"attempts": null
},
"saml_connection": {"id": null,
"name": null,
"domain": null,
"active": null,
"provider": null,
"sync_user_attributes": null,
"allow_subdomains": null,
"allow_idp_initiated": null,
"disable_additional_identifications": null,
"created_at": null,
"updated_at": null
}
}
],
"last_sign_in_at": 0,
"banned": true,
"locked": true,
"lockout_expires_in_seconds": 0,
"verification_attempts_remaining": 0,
"updated_at": 0,
"created_at": 0,
"delete_self_enabled": true,
"create_organization_enabled": true,
"create_organizations_limit": 0,
"last_active_at": 0,
"legal_accepted_at": 1700690400000
},
"public_user_data": {"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"identifier": "string"
}
}
],
"last_active_session_id": "string",
"updated_at": 0,
"created_at": 0
}
}

Delete Client's Sessions

Ends all Sessions of the Current Client

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)

Responses

200

Returns the response for DELETE session object.

307

Redirect, no body.

404

Request was not successful

delete/v1/client

Response samples

application/json

{"response": {"object": "client",
"id": "string",
"sign_in": {"object": "sign_in_attempt",
"id": "string",
"status": "abandoned",
"supported_identifiers": ["email_address"
],
"identifier": "string",
"user_data": {"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true
},
"supported_first_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"default": true
}
],
"first_factor_verification": {"status": "unverified",
"strategy": "password",
"attempts": 0,
"expire_at": 0
},
"supported_second_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"default": true
}
],
"second_factor_verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"created_session_id": "string",
"abandon_at": 0
},
"sign_up": {"object": "sign_up_attempt",
"id": "string",
"status": "abandoned",
"required_fields": ["string"
],
"optional_fields": ["string"
],
"missing_fields": ["string"
],
"unverified_fields": ["string"
],
"verifications": {"email_address": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"phone_number": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"external_account": {"status": "unverified",
"strategy": "string",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
}
},
"username": "string",
"email_address": "string",
"phone_number": "string",
"web3_wallet": "string",
"password_enabled": true,
"first_name": "string",
"last_name": "string",
"unsafe_metadata": { },
"public_metadata": { },
"external_id": "string",
"created_session_id": "string",
"created_user_id": "string",
"abandon_at": 0,
"legal_accepted_at": 1700690400000
},
"sessions": [{"id": "string",
"object": "session",
"actor": { },
"status": "active",
"last_active_at": 0,
"expire_at": 0,
"abandon_at": 0,
"user": {"id": "string",
"object": "user",
"external_id": "string",
"primary_email_address_id": "string",
"primary_phone_number_id": "string",
"primary_web3_wallet_id": "string",
"username": "string",
"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"public_metadata": { },
"private_metadata": { },
"unsafe_metadata": { },
"email_addresses": [{"id": "string",
"object": "email_address",
"email_address": "string",
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"created_at": 0,
"updated_at": 0
}
],
"phone_numbers": [{"id": "string",
"object": "phone_number",
"phone_number": "string",
"reserved_for_second_factor": true,
"default_second_factor": true,
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"backup_codes": [null
],
"created_at": 0,
"updated_at": 0
}
],
"web3_wallets": [{"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null,
"message": null
},
"created_at": 0,
"updated_at": 0
}
],
"passkeys": [{"id": "string",
"object": "passkey",
"name": "string",
"last_used_at": 0,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null
},
"created_at": 0,
"updated_at": 0
}
],
"organization_memberships": [{"id": "string",
"object": "organization_membership",
"role": "string",
"created_at": 0,
"updated_at": 0,
"organization": {"id": null,
"object": null,
"name": null,
"max_allowed_memberships": null,
"admin_delete_enabled": null,
"slug": null,
"logo_url": null,
"image_url": null,
"has_image": null,
"members_count": null,
"pending_invitations_count": null,
"public_metadata": { },
"created_at": null,
"updated_at": null
},
"public_user_data": {"user_id": null,
"first_name": null,
"last_name": null,
"profile_image_url": null,
"image_url": null,
"has_image": null,
"identifier": null
}
}
],
"password_enabled": true,
"two_factor_enabled": true,
"totp_enabled": true,
"backup_code_enabled": true,
"external_accounts": [{"object": "external_account",
"id": "string",
"provider": "string",
"provider_user_id": "string",
"approved_scopes": "string",
"email_address": "string",
"first_name": "string",
"last_name": "string",
"avatar_url": "string",
"image_url": "string",
"username": "string",
"public_metadata": { },
"label": "string",
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": { },
"expire_at": null,
"attempts": null
},
"created_at": 0,
"updated_at": 0
}
],
"saml_accounts": [{"id": "string",
"object": "saml_account",
"provider": "string",
"active": true,
"email_address": "string",
"first_name": "string",
"last_name": "string",
"provider_user_id": "string",
"public_metadata": { },
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": null,
"expire_at": null,
"attempts": null
},
"saml_connection": {"id": null,
"name": null,
"domain": null,
"active": null,
"provider": null,
"sync_user_attributes": null,
"allow_subdomains": null,
"allow_idp_initiated": null,
"disable_additional_identifications": null,
"created_at": null,
"updated_at": null
}
}
],
"last_sign_in_at": 0,
"banned": true,
"locked": true,
"lockout_expires_in_seconds": 0,
"verification_attempts_remaining": 0,
"updated_at": 0,
"created_at": 0,
"delete_self_enabled": true,
"create_organization_enabled": true,
"create_organizations_limit": 0,
"last_active_at": 0,
"legal_accepted_at": 1700690400000
},
"public_user_data": {"first_name": "string",
"last_name": "string",
"profile_image_url": "string",
"image_url": "string",
"has_image": true,
"identifier": "string"
}
}
],
"last_active_session_id": "string",
"updated_at": 0,
"created_at": 0
},
"client": { }
}

Generate and returns a new session token for a given client.

When the authentication status cannot be determined from the current session token, we initiate a handshake to refresh the token and send it back to the application. Called in server environments.

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)

Request

query Parameters

redirect_url	string The URL to redirect back to after the handshake
organization_id	string The organization ID or slug to attempt to set as active for the session. If this param is present but has no value, the personal workspace will be set as active. If the organization cannot be set as active (because it does not exist, or the user is not a member), the active organization for the session will not change.

Responses

307

Redirect

400

Request was not successful

403

Request was not successful

404

Request was not successful

422

Request was not successful

500

Request was not successful

get/v1/client/handshake

Response samples

application/json

{"errors": [{"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
}
],
"meta": { }
}

➔ Next to Sessions