POST /oauth/bind

Binds the current user's AuthMS account to a third-party OAuth provider account. Requires JWT authentication; user_id in request body must match JWT subject.

Request Body

Schema: dto.BindOAuthRequest

Field	Type	Required	Example	Constraints	Description
access_token	string	Yes
provider	string	Yes
provider_user_id	string	Yes
user_id	string	Yes
profile_data	object	No
refresh_token	string	No

Responses

Status	Description	Schema
201	Binding successful	dto.DataResponse-dto_OAuthBindData
400	Invalid request parameters	gitee_com_linmes_authms_base_dto.SimpleResponse
401	Unauthenticated	gitee_com_linmes_authms_base_dto.SimpleResponse
403	user_id does not match JWT	gitee_com_linmes_authms_base_dto.SimpleResponse
409	Already bound to this provider	gitee_com_linmes_authms_base_dto.SimpleResponse
500	Internal server error	gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.DataResponse-dto_OAuthBindData

Field	Type	Required	Example	Constraints	Description
code	integer	No
data	dto.OAuthBindData	No
message	string	No
timestamp	string	No

dto.OAuthBindData

Field	Type	Required	Example	Constraints	Description
connection	dto.OAuthConnectionItem	No

dto.OAuthConnectionItem

Field	Type	Required	Example	Constraints	Description
created_at	string	No	2026-04-15T10:30:00Z
id	string	No	conn_abc123
profile_data	object	No
provider_id	string	No	github
provider_user_id	string	No	12345678
tenant_id	string	No	tenant_abc123
token_expiry	string	No	2026-04-15T10:30:00Z
updated_at	string	No	2026-04-15T10:30:00Z
user_id	string	No	usr_abc123

gitee_com_linmes_authms_base_dto.SimpleResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
message	string	No
timestamp	string	No