Skip to main content
POST
Start Credential Binding

Headers

x-user-id
string
required

Caller's user ID. Temporary header-based identity; will be replaced by JWT auth.

Body

application/json

Request body for opening a credential-binding session.

channel_type
string
required

Channel type id, e.g. 'feishu'.

Response

Successful Response

What a client is allowed to see while a session is open.

binding_id
string
required
state
enum<string>
required

Where a binding session is in its lifecycle.

Available options:
pending,
authorized,
failed,
cancelled
verification_url
string
default:""
error
string
default:""
retry_after_secs
integer
default:5