@polaris-auth/client 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/openapi.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "openapi": "3.1.0",
3
3
  "info": {
4
4
  "title": "Polaris for PHP",
5
- "version": "0.7.0",
5
+ "version": "0.8.0",
6
6
  "description": "Self-hosted authentication, MFA, organizations and RBAC."
7
7
  },
8
8
  "paths": {
@@ -17010,6 +17010,1894 @@
17010
17010
  }
17011
17011
  }
17012
17012
  }
17013
+ },
17014
+ "/social/accounts": {
17015
+ "get": {
17016
+ "operationId": "get_social_AccountsEndpoint",
17017
+ "summary": "List your linked provider accounts",
17018
+ "tags": [
17019
+ "social"
17020
+ ],
17021
+ "x-polaris-effect": "read",
17022
+ "x-polaris-receipt": false,
17023
+ "x-polaris-plugin": "social",
17024
+ "security": [
17025
+ {
17026
+ "bearerAuth": []
17027
+ }
17028
+ ],
17029
+ "responses": {
17030
+ "200": {
17031
+ "description": "Success",
17032
+ "content": {
17033
+ "application/json": {
17034
+ "schema": {
17035
+ "type": "object",
17036
+ "properties": {
17037
+ "data": {
17038
+ "type": "array",
17039
+ "items": {
17040
+ "type": "object",
17041
+ "properties": {
17042
+ "id": {
17043
+ "type": "string"
17044
+ },
17045
+ "provider": {
17046
+ "type": "string"
17047
+ },
17048
+ "provider_account_id": {
17049
+ "type": "string"
17050
+ },
17051
+ "email": {
17052
+ "type": "string"
17053
+ },
17054
+ "email_verified": {
17055
+ "type": "boolean"
17056
+ },
17057
+ "scopes": {
17058
+ "type": "array",
17059
+ "items": {
17060
+ "type": "string"
17061
+ }
17062
+ },
17063
+ "profile": {
17064
+ "type": "object",
17065
+ "properties": {
17066
+ "name": {
17067
+ "type": "string"
17068
+ },
17069
+ "picture": {
17070
+ "type": "string"
17071
+ }
17072
+ },
17073
+ "required": [
17074
+ "name",
17075
+ "picture"
17076
+ ]
17077
+ },
17078
+ "created_at": {
17079
+ "type": "string"
17080
+ },
17081
+ "updated_at": {
17082
+ "type": "string"
17083
+ }
17084
+ },
17085
+ "required": [
17086
+ "id",
17087
+ "provider",
17088
+ "provider_account_id",
17089
+ "email",
17090
+ "email_verified",
17091
+ "scopes",
17092
+ "profile",
17093
+ "created_at",
17094
+ "updated_at"
17095
+ ]
17096
+ }
17097
+ }
17098
+ },
17099
+ "required": [
17100
+ "data"
17101
+ ]
17102
+ },
17103
+ "example": {
17104
+ "data": [
17105
+ {
17106
+ "id": "018f...",
17107
+ "provider": "google",
17108
+ "provider_account_id": "1029384756",
17109
+ "email": "ada@example.com",
17110
+ "email_verified": true,
17111
+ "scopes": [
17112
+ "openid",
17113
+ "email",
17114
+ "profile"
17115
+ ],
17116
+ "profile": {
17117
+ "name": "Ada",
17118
+ "picture": "https://..."
17119
+ },
17120
+ "created_at": "2026-10-09T10:00:00+00:00",
17121
+ "updated_at": "2026-10-09T10:00:00+00:00"
17122
+ }
17123
+ ]
17124
+ }
17125
+ }
17126
+ }
17127
+ },
17128
+ "401": {
17129
+ "description": "unauthorized",
17130
+ "content": {
17131
+ "application/problem+json": {
17132
+ "schema": {
17133
+ "$ref": "#/components/schemas/Problem"
17134
+ }
17135
+ }
17136
+ }
17137
+ }
17138
+ }
17139
+ }
17140
+ },
17141
+ "/social/{provider}/callback": {
17142
+ "post": {
17143
+ "operationId": "post_social_CallbackPostEndpoint",
17144
+ "summary": "The provider's callback (form_post)",
17145
+ "tags": [
17146
+ "social"
17147
+ ],
17148
+ "x-polaris-effect": "write",
17149
+ "x-polaris-receipt": false,
17150
+ "x-polaris-plugin": "social",
17151
+ "x-polaris-rate-limit": "token_consume",
17152
+ "parameters": [
17153
+ {
17154
+ "name": "provider",
17155
+ "in": "path",
17156
+ "required": true,
17157
+ "schema": {
17158
+ "type": "string"
17159
+ }
17160
+ }
17161
+ ],
17162
+ "requestBody": {
17163
+ "required": true,
17164
+ "content": {
17165
+ "application/json": {
17166
+ "schema": {
17167
+ "type": "object",
17168
+ "properties": {
17169
+ "code": {
17170
+ "type": "string",
17171
+ "format": "password",
17172
+ "x-polaris-sensitive": true
17173
+ },
17174
+ "state": {
17175
+ "type": "string"
17176
+ },
17177
+ "error": {
17178
+ "type": "string"
17179
+ },
17180
+ "user": {
17181
+ "type": "string"
17182
+ }
17183
+ },
17184
+ "required": [
17185
+ "state"
17186
+ ]
17187
+ }
17188
+ }
17189
+ }
17190
+ },
17191
+ "responses": {
17192
+ "302": {
17193
+ "description": "Success",
17194
+ "content": {
17195
+ "application/json": {
17196
+ "schema": {
17197
+ "type": "array",
17198
+ "items": []
17199
+ },
17200
+ "example": []
17201
+ }
17202
+ }
17203
+ },
17204
+ "403": {
17205
+ "description": "social_provider_error | social_account_disabled | social_email_unverified",
17206
+ "content": {
17207
+ "application/problem+json": {
17208
+ "schema": {
17209
+ "$ref": "#/components/schemas/Problem"
17210
+ }
17211
+ }
17212
+ }
17213
+ },
17214
+ "409": {
17215
+ "description": "social_account_exists | social_account_linked | social_email_mismatch",
17216
+ "content": {
17217
+ "application/problem+json": {
17218
+ "schema": {
17219
+ "$ref": "#/components/schemas/Problem"
17220
+ }
17221
+ }
17222
+ }
17223
+ },
17224
+ "422": {
17225
+ "description": "social_email_required | social_state_invalid",
17226
+ "content": {
17227
+ "application/problem+json": {
17228
+ "schema": {
17229
+ "$ref": "#/components/schemas/Problem"
17230
+ }
17231
+ }
17232
+ }
17233
+ },
17234
+ "404": {
17235
+ "description": "social_provider_not_found",
17236
+ "content": {
17237
+ "application/problem+json": {
17238
+ "schema": {
17239
+ "$ref": "#/components/schemas/Problem"
17240
+ }
17241
+ }
17242
+ }
17243
+ }
17244
+ }
17245
+ },
17246
+ "get": {
17247
+ "operationId": "get_social_CallbackEndpoint",
17248
+ "summary": "The provider's callback",
17249
+ "tags": [
17250
+ "social"
17251
+ ],
17252
+ "x-polaris-effect": "write",
17253
+ "x-polaris-receipt": false,
17254
+ "x-polaris-plugin": "social",
17255
+ "x-polaris-rate-limit": "token_consume",
17256
+ "parameters": [
17257
+ {
17258
+ "name": "provider",
17259
+ "in": "path",
17260
+ "required": true,
17261
+ "schema": {
17262
+ "type": "string"
17263
+ }
17264
+ },
17265
+ {
17266
+ "name": "code",
17267
+ "in": "query",
17268
+ "required": false,
17269
+ "schema": {
17270
+ "type": "string",
17271
+ "format": "password",
17272
+ "x-polaris-sensitive": true
17273
+ }
17274
+ },
17275
+ {
17276
+ "name": "state",
17277
+ "in": "query",
17278
+ "required": true,
17279
+ "schema": {
17280
+ "type": "string"
17281
+ }
17282
+ },
17283
+ {
17284
+ "name": "error",
17285
+ "in": "query",
17286
+ "required": false,
17287
+ "schema": {
17288
+ "type": "string"
17289
+ }
17290
+ }
17291
+ ],
17292
+ "responses": {
17293
+ "302": {
17294
+ "description": "Success",
17295
+ "content": {
17296
+ "application/json": {
17297
+ "schema": {
17298
+ "type": "array",
17299
+ "items": []
17300
+ },
17301
+ "example": []
17302
+ }
17303
+ }
17304
+ },
17305
+ "403": {
17306
+ "description": "social_provider_error | social_account_disabled | social_email_unverified",
17307
+ "content": {
17308
+ "application/problem+json": {
17309
+ "schema": {
17310
+ "$ref": "#/components/schemas/Problem"
17311
+ }
17312
+ }
17313
+ }
17314
+ },
17315
+ "409": {
17316
+ "description": "social_account_exists | social_account_linked | social_email_mismatch",
17317
+ "content": {
17318
+ "application/problem+json": {
17319
+ "schema": {
17320
+ "$ref": "#/components/schemas/Problem"
17321
+ }
17322
+ }
17323
+ }
17324
+ },
17325
+ "422": {
17326
+ "description": "social_email_required | social_state_invalid",
17327
+ "content": {
17328
+ "application/problem+json": {
17329
+ "schema": {
17330
+ "$ref": "#/components/schemas/Problem"
17331
+ }
17332
+ }
17333
+ }
17334
+ },
17335
+ "404": {
17336
+ "description": "social_provider_not_found",
17337
+ "content": {
17338
+ "application/problem+json": {
17339
+ "schema": {
17340
+ "$ref": "#/components/schemas/Problem"
17341
+ }
17342
+ }
17343
+ }
17344
+ }
17345
+ }
17346
+ }
17347
+ },
17348
+ "/social/exchange": {
17349
+ "post": {
17350
+ "operationId": "post_social_ExchangeEndpoint",
17351
+ "summary": "Exchange the sign-in code for the session",
17352
+ "tags": [
17353
+ "social"
17354
+ ],
17355
+ "x-polaris-effect": "write",
17356
+ "x-polaris-receipt": false,
17357
+ "x-polaris-plugin": "social",
17358
+ "x-polaris-rate-limit": "token_consume",
17359
+ "requestBody": {
17360
+ "required": true,
17361
+ "content": {
17362
+ "application/json": {
17363
+ "schema": {
17364
+ "type": "object",
17365
+ "properties": {
17366
+ "code": {
17367
+ "type": "string",
17368
+ "format": "password",
17369
+ "x-polaris-sensitive": true
17370
+ }
17371
+ },
17372
+ "required": [
17373
+ "code"
17374
+ ]
17375
+ }
17376
+ }
17377
+ }
17378
+ },
17379
+ "responses": {
17380
+ "200": {
17381
+ "description": "Success",
17382
+ "content": {
17383
+ "application/json": {
17384
+ "schema": {
17385
+ "type": "object",
17386
+ "properties": {
17387
+ "data": {
17388
+ "type": "object",
17389
+ "properties": {
17390
+ "access_token": {
17391
+ "type": "string"
17392
+ },
17393
+ "token_type": {
17394
+ "type": "string"
17395
+ },
17396
+ "expires_in": {
17397
+ "type": "integer"
17398
+ },
17399
+ "refresh_token": {
17400
+ "type": "string"
17401
+ },
17402
+ "user": {
17403
+ "type": "object",
17404
+ "properties": {
17405
+ "id": {
17406
+ "type": "string"
17407
+ },
17408
+ "email": {
17409
+ "type": "string"
17410
+ },
17411
+ "email_verified": {
17412
+ "type": "boolean"
17413
+ }
17414
+ },
17415
+ "required": [
17416
+ "id",
17417
+ "email",
17418
+ "email_verified"
17419
+ ]
17420
+ }
17421
+ },
17422
+ "required": [
17423
+ "access_token",
17424
+ "token_type",
17425
+ "expires_in",
17426
+ "refresh_token",
17427
+ "user"
17428
+ ]
17429
+ }
17430
+ },
17431
+ "required": [
17432
+ "data"
17433
+ ]
17434
+ },
17435
+ "example": {
17436
+ "data": {
17437
+ "access_token": "<jwt>",
17438
+ "token_type": "Bearer",
17439
+ "expires_in": 900,
17440
+ "refresh_token": "<opaque>",
17441
+ "user": {
17442
+ "id": "018f...",
17443
+ "email": "ada@example.com",
17444
+ "email_verified": true
17445
+ }
17446
+ }
17447
+ }
17448
+ }
17449
+ }
17450
+ },
17451
+ "422": {
17452
+ "description": "social_code_invalid | social_invalid_input",
17453
+ "content": {
17454
+ "application/problem+json": {
17455
+ "schema": {
17456
+ "$ref": "#/components/schemas/Problem"
17457
+ }
17458
+ }
17459
+ }
17460
+ }
17461
+ }
17462
+ }
17463
+ },
17464
+ "/social/{provider}/link": {
17465
+ "post": {
17466
+ "operationId": "post_social_LinkEndpoint",
17467
+ "summary": "Link a provider to your account",
17468
+ "tags": [
17469
+ "social"
17470
+ ],
17471
+ "x-polaris-effect": "write",
17472
+ "x-polaris-receipt": true,
17473
+ "x-polaris-plugin": "social",
17474
+ "x-polaris-rate-limit": "mfa_enroll",
17475
+ "x-polaris-step-up": true,
17476
+ "security": [
17477
+ {
17478
+ "bearerAuth": []
17479
+ }
17480
+ ],
17481
+ "parameters": [
17482
+ {
17483
+ "name": "provider",
17484
+ "in": "path",
17485
+ "required": true,
17486
+ "schema": {
17487
+ "type": "string"
17488
+ }
17489
+ }
17490
+ ],
17491
+ "requestBody": {
17492
+ "required": true,
17493
+ "content": {
17494
+ "application/json": {
17495
+ "schema": {
17496
+ "type": "object",
17497
+ "properties": {
17498
+ "redirect_uri": {
17499
+ "type": "string"
17500
+ },
17501
+ "scopes": {
17502
+ "type": "string"
17503
+ }
17504
+ }
17505
+ }
17506
+ }
17507
+ }
17508
+ },
17509
+ "responses": {
17510
+ "200": {
17511
+ "description": "Success",
17512
+ "content": {
17513
+ "application/json": {
17514
+ "schema": {
17515
+ "type": "object",
17516
+ "properties": {
17517
+ "data": {
17518
+ "type": "object",
17519
+ "properties": {
17520
+ "url": {
17521
+ "type": "string"
17522
+ },
17523
+ "state": {
17524
+ "type": "string"
17525
+ }
17526
+ },
17527
+ "required": [
17528
+ "url",
17529
+ "state"
17530
+ ]
17531
+ }
17532
+ },
17533
+ "required": [
17534
+ "data"
17535
+ ]
17536
+ },
17537
+ "example": {
17538
+ "data": {
17539
+ "url": "https://github.com/login/oauth/authorize?client_id=...&state=...",
17540
+ "state": "<opaque>"
17541
+ }
17542
+ }
17543
+ }
17544
+ }
17545
+ },
17546
+ "401": {
17547
+ "description": "unauthorized | step_up_required",
17548
+ "content": {
17549
+ "application/problem+json": {
17550
+ "schema": {
17551
+ "$ref": "#/components/schemas/Problem"
17552
+ }
17553
+ }
17554
+ }
17555
+ },
17556
+ "404": {
17557
+ "description": "social_provider_not_found",
17558
+ "content": {
17559
+ "application/problem+json": {
17560
+ "schema": {
17561
+ "$ref": "#/components/schemas/Problem"
17562
+ }
17563
+ }
17564
+ }
17565
+ },
17566
+ "422": {
17567
+ "description": "social_redirect_not_allowed",
17568
+ "content": {
17569
+ "application/problem+json": {
17570
+ "schema": {
17571
+ "$ref": "#/components/schemas/Problem"
17572
+ }
17573
+ }
17574
+ }
17575
+ }
17576
+ }
17577
+ }
17578
+ },
17579
+ "/social/google/one-tap": {
17580
+ "post": {
17581
+ "operationId": "post_social_OneTapEndpoint",
17582
+ "summary": "Sign in with Google One Tap",
17583
+ "tags": [
17584
+ "social"
17585
+ ],
17586
+ "x-polaris-effect": "write",
17587
+ "x-polaris-receipt": true,
17588
+ "x-polaris-plugin": "social",
17589
+ "x-polaris-rate-limit": "login",
17590
+ "requestBody": {
17591
+ "required": true,
17592
+ "content": {
17593
+ "application/json": {
17594
+ "schema": {
17595
+ "type": "object",
17596
+ "properties": {
17597
+ "credential": {
17598
+ "type": "string",
17599
+ "format": "password",
17600
+ "x-polaris-sensitive": true
17601
+ }
17602
+ },
17603
+ "required": [
17604
+ "credential"
17605
+ ]
17606
+ }
17607
+ }
17608
+ }
17609
+ },
17610
+ "responses": {
17611
+ "200": {
17612
+ "description": "Success",
17613
+ "content": {
17614
+ "application/json": {
17615
+ "schema": {
17616
+ "type": "object",
17617
+ "properties": {
17618
+ "data": {
17619
+ "type": "object",
17620
+ "properties": {
17621
+ "access_token": {
17622
+ "type": "string"
17623
+ },
17624
+ "token_type": {
17625
+ "type": "string"
17626
+ },
17627
+ "expires_in": {
17628
+ "type": "integer"
17629
+ },
17630
+ "refresh_token": {
17631
+ "type": "string"
17632
+ },
17633
+ "user": {
17634
+ "type": "object",
17635
+ "properties": {
17636
+ "id": {
17637
+ "type": "string"
17638
+ },
17639
+ "email": {
17640
+ "type": "string"
17641
+ },
17642
+ "email_verified": {
17643
+ "type": "boolean"
17644
+ }
17645
+ },
17646
+ "required": [
17647
+ "id",
17648
+ "email",
17649
+ "email_verified"
17650
+ ]
17651
+ }
17652
+ },
17653
+ "required": [
17654
+ "access_token",
17655
+ "token_type",
17656
+ "expires_in",
17657
+ "refresh_token",
17658
+ "user"
17659
+ ]
17660
+ }
17661
+ },
17662
+ "required": [
17663
+ "data"
17664
+ ]
17665
+ },
17666
+ "example": {
17667
+ "data": {
17668
+ "access_token": "<jwt>",
17669
+ "token_type": "Bearer",
17670
+ "expires_in": 900,
17671
+ "refresh_token": "<opaque>",
17672
+ "user": {
17673
+ "id": "018f...",
17674
+ "email": "ada@example.com",
17675
+ "email_verified": true
17676
+ }
17677
+ }
17678
+ }
17679
+ }
17680
+ }
17681
+ },
17682
+ "403": {
17683
+ "description": "social_provider_error | social_account_disabled | social_email_unverified",
17684
+ "content": {
17685
+ "application/problem+json": {
17686
+ "schema": {
17687
+ "$ref": "#/components/schemas/Problem"
17688
+ }
17689
+ }
17690
+ }
17691
+ },
17692
+ "404": {
17693
+ "description": "social_provider_not_found",
17694
+ "content": {
17695
+ "application/problem+json": {
17696
+ "schema": {
17697
+ "$ref": "#/components/schemas/Problem"
17698
+ }
17699
+ }
17700
+ }
17701
+ },
17702
+ "409": {
17703
+ "description": "social_account_exists",
17704
+ "content": {
17705
+ "application/problem+json": {
17706
+ "schema": {
17707
+ "$ref": "#/components/schemas/Problem"
17708
+ }
17709
+ }
17710
+ }
17711
+ },
17712
+ "422": {
17713
+ "description": "social_invalid_input",
17714
+ "content": {
17715
+ "application/problem+json": {
17716
+ "schema": {
17717
+ "$ref": "#/components/schemas/Problem"
17718
+ }
17719
+ }
17720
+ }
17721
+ }
17722
+ }
17723
+ }
17724
+ },
17725
+ "/social/{provider}/start": {
17726
+ "post": {
17727
+ "operationId": "post_social_StartEndpoint",
17728
+ "summary": "Start a social sign-in",
17729
+ "tags": [
17730
+ "social"
17731
+ ],
17732
+ "x-polaris-effect": "write",
17733
+ "x-polaris-receipt": false,
17734
+ "x-polaris-plugin": "social",
17735
+ "x-polaris-rate-limit": "login",
17736
+ "parameters": [
17737
+ {
17738
+ "name": "provider",
17739
+ "in": "path",
17740
+ "required": true,
17741
+ "schema": {
17742
+ "type": "string"
17743
+ }
17744
+ }
17745
+ ],
17746
+ "requestBody": {
17747
+ "required": true,
17748
+ "content": {
17749
+ "application/json": {
17750
+ "schema": {
17751
+ "type": "object",
17752
+ "properties": {
17753
+ "redirect_uri": {
17754
+ "type": "string"
17755
+ },
17756
+ "scopes": {
17757
+ "type": "string"
17758
+ }
17759
+ }
17760
+ }
17761
+ }
17762
+ }
17763
+ },
17764
+ "responses": {
17765
+ "200": {
17766
+ "description": "Success",
17767
+ "content": {
17768
+ "application/json": {
17769
+ "schema": {
17770
+ "type": "object",
17771
+ "properties": {
17772
+ "data": {
17773
+ "type": "object",
17774
+ "properties": {
17775
+ "url": {
17776
+ "type": "string"
17777
+ },
17778
+ "state": {
17779
+ "type": "string"
17780
+ }
17781
+ },
17782
+ "required": [
17783
+ "url",
17784
+ "state"
17785
+ ]
17786
+ }
17787
+ },
17788
+ "required": [
17789
+ "data"
17790
+ ]
17791
+ },
17792
+ "example": {
17793
+ "data": {
17794
+ "url": "https://accounts.google.com/o/oauth2/v2/auth?client_id=...&state=...",
17795
+ "state": "<opaque>"
17796
+ }
17797
+ }
17798
+ }
17799
+ }
17800
+ },
17801
+ "404": {
17802
+ "description": "social_provider_not_found",
17803
+ "content": {
17804
+ "application/problem+json": {
17805
+ "schema": {
17806
+ "$ref": "#/components/schemas/Problem"
17807
+ }
17808
+ }
17809
+ }
17810
+ },
17811
+ "422": {
17812
+ "description": "social_redirect_not_allowed",
17813
+ "content": {
17814
+ "application/problem+json": {
17815
+ "schema": {
17816
+ "$ref": "#/components/schemas/Problem"
17817
+ }
17818
+ }
17819
+ }
17820
+ }
17821
+ }
17822
+ }
17823
+ },
17824
+ "/social/{provider}/token": {
17825
+ "post": {
17826
+ "operationId": "post_social_TokenEndpoint",
17827
+ "summary": "Get a provider token for the user",
17828
+ "tags": [
17829
+ "social"
17830
+ ],
17831
+ "x-polaris-effect": "write",
17832
+ "x-polaris-receipt": true,
17833
+ "x-polaris-plugin": "social",
17834
+ "x-polaris-step-up": true,
17835
+ "security": [
17836
+ {
17837
+ "bearerAuth": []
17838
+ }
17839
+ ],
17840
+ "parameters": [
17841
+ {
17842
+ "name": "provider",
17843
+ "in": "path",
17844
+ "required": true,
17845
+ "schema": {
17846
+ "type": "string"
17847
+ }
17848
+ }
17849
+ ],
17850
+ "responses": {
17851
+ "200": {
17852
+ "description": "Success",
17853
+ "content": {
17854
+ "application/json": {
17855
+ "schema": {
17856
+ "type": "object",
17857
+ "properties": {
17858
+ "data": {
17859
+ "type": "object",
17860
+ "properties": {
17861
+ "access_token": {
17862
+ "type": "string"
17863
+ },
17864
+ "expires_at": {
17865
+ "type": "string"
17866
+ },
17867
+ "scopes": {
17868
+ "type": "array",
17869
+ "items": {
17870
+ "type": "string"
17871
+ }
17872
+ }
17873
+ },
17874
+ "required": [
17875
+ "access_token",
17876
+ "expires_at",
17877
+ "scopes"
17878
+ ]
17879
+ }
17880
+ },
17881
+ "required": [
17882
+ "data"
17883
+ ]
17884
+ },
17885
+ "example": {
17886
+ "data": {
17887
+ "access_token": "<opaque>",
17888
+ "expires_at": "2026-10-09T11:00:00+00:00",
17889
+ "scopes": [
17890
+ "repo"
17891
+ ]
17892
+ }
17893
+ }
17894
+ }
17895
+ }
17896
+ },
17897
+ "401": {
17898
+ "description": "unauthorized | step_up_required",
17899
+ "content": {
17900
+ "application/problem+json": {
17901
+ "schema": {
17902
+ "$ref": "#/components/schemas/Problem"
17903
+ }
17904
+ }
17905
+ }
17906
+ },
17907
+ "404": {
17908
+ "description": "social_not_linked",
17909
+ "content": {
17910
+ "application/problem+json": {
17911
+ "schema": {
17912
+ "$ref": "#/components/schemas/Problem"
17913
+ }
17914
+ }
17915
+ }
17916
+ },
17917
+ "409": {
17918
+ "description": "social_no_refresh",
17919
+ "content": {
17920
+ "application/problem+json": {
17921
+ "schema": {
17922
+ "$ref": "#/components/schemas/Problem"
17923
+ }
17924
+ }
17925
+ }
17926
+ }
17927
+ }
17928
+ }
17929
+ },
17930
+ "/social/{provider}": {
17931
+ "delete": {
17932
+ "operationId": "delete_social_UnlinkEndpoint",
17933
+ "summary": "Unlink a provider",
17934
+ "tags": [
17935
+ "social"
17936
+ ],
17937
+ "x-polaris-effect": "destructive",
17938
+ "x-polaris-receipt": true,
17939
+ "x-polaris-plugin": "social",
17940
+ "x-polaris-step-up": true,
17941
+ "security": [
17942
+ {
17943
+ "bearerAuth": []
17944
+ }
17945
+ ],
17946
+ "parameters": [
17947
+ {
17948
+ "name": "provider",
17949
+ "in": "path",
17950
+ "required": true,
17951
+ "schema": {
17952
+ "type": "string"
17953
+ }
17954
+ }
17955
+ ],
17956
+ "responses": {
17957
+ "200": {
17958
+ "description": "Success",
17959
+ "content": {
17960
+ "application/json": {
17961
+ "schema": {
17962
+ "type": "object",
17963
+ "properties": {
17964
+ "data": {
17965
+ "type": "object",
17966
+ "properties": {
17967
+ "status": {
17968
+ "type": "string"
17969
+ }
17970
+ },
17971
+ "required": [
17972
+ "status"
17973
+ ]
17974
+ }
17975
+ },
17976
+ "required": [
17977
+ "data"
17978
+ ]
17979
+ },
17980
+ "example": {
17981
+ "data": {
17982
+ "status": "unlinked"
17983
+ }
17984
+ }
17985
+ }
17986
+ }
17987
+ },
17988
+ "401": {
17989
+ "description": "unauthorized | step_up_required",
17990
+ "content": {
17991
+ "application/problem+json": {
17992
+ "schema": {
17993
+ "$ref": "#/components/schemas/Problem"
17994
+ }
17995
+ }
17996
+ }
17997
+ },
17998
+ "404": {
17999
+ "description": "social_not_linked",
18000
+ "content": {
18001
+ "application/problem+json": {
18002
+ "schema": {
18003
+ "$ref": "#/components/schemas/Problem"
18004
+ }
18005
+ }
18006
+ }
18007
+ },
18008
+ "409": {
18009
+ "description": "social_last_credential",
18010
+ "content": {
18011
+ "application/problem+json": {
18012
+ "schema": {
18013
+ "$ref": "#/components/schemas/Problem"
18014
+ }
18015
+ }
18016
+ }
18017
+ }
18018
+ }
18019
+ }
18020
+ },
18021
+ "/passkey/authenticate/options": {
18022
+ "post": {
18023
+ "operationId": "post_passkey_AuthenticateOptionsEndpoint",
18024
+ "summary": "Start a passkey sign-in",
18025
+ "tags": [
18026
+ "passkey"
18027
+ ],
18028
+ "x-polaris-effect": "write",
18029
+ "x-polaris-receipt": false,
18030
+ "x-polaris-plugin": "passkey",
18031
+ "x-polaris-rate-limit": "token_refresh",
18032
+ "responses": {
18033
+ "200": {
18034
+ "description": "Success",
18035
+ "content": {
18036
+ "application/json": {
18037
+ "schema": {
18038
+ "type": "object",
18039
+ "properties": {
18040
+ "data": {
18041
+ "type": "object",
18042
+ "properties": {
18043
+ "challenge": {
18044
+ "type": "string"
18045
+ },
18046
+ "rpId": {
18047
+ "type": "string"
18048
+ },
18049
+ "allowCredentials": {
18050
+ "type": "array",
18051
+ "items": []
18052
+ },
18053
+ "userVerification": {
18054
+ "type": "string"
18055
+ },
18056
+ "timeout": {
18057
+ "type": "integer"
18058
+ }
18059
+ },
18060
+ "required": [
18061
+ "challenge",
18062
+ "rpId",
18063
+ "allowCredentials",
18064
+ "userVerification",
18065
+ "timeout"
18066
+ ]
18067
+ }
18068
+ },
18069
+ "required": [
18070
+ "data"
18071
+ ]
18072
+ },
18073
+ "example": {
18074
+ "data": {
18075
+ "challenge": "<opaque>",
18076
+ "rpId": "app.example.com",
18077
+ "allowCredentials": [],
18078
+ "userVerification": "preferred",
18079
+ "timeout": 60000
18080
+ }
18081
+ }
18082
+ }
18083
+ }
18084
+ }
18085
+ }
18086
+ }
18087
+ },
18088
+ "/passkey/authenticate/verify": {
18089
+ "post": {
18090
+ "operationId": "post_passkey_AuthenticateVerifyEndpoint",
18091
+ "summary": "Sign in with a passkey",
18092
+ "tags": [
18093
+ "passkey"
18094
+ ],
18095
+ "x-polaris-effect": "write",
18096
+ "x-polaris-receipt": true,
18097
+ "x-polaris-plugin": "passkey",
18098
+ "x-polaris-rate-limit": "login",
18099
+ "requestBody": {
18100
+ "required": true,
18101
+ "content": {
18102
+ "application/json": {
18103
+ "schema": {
18104
+ "type": "object",
18105
+ "properties": {
18106
+ "credential": {
18107
+ "type": "object",
18108
+ "additionalProperties": true
18109
+ }
18110
+ },
18111
+ "required": [
18112
+ "credential"
18113
+ ]
18114
+ }
18115
+ }
18116
+ }
18117
+ },
18118
+ "responses": {
18119
+ "200": {
18120
+ "description": "Success",
18121
+ "content": {
18122
+ "application/json": {
18123
+ "schema": {
18124
+ "type": "object",
18125
+ "properties": {
18126
+ "data": {
18127
+ "type": "object",
18128
+ "properties": {
18129
+ "access_token": {
18130
+ "type": "string"
18131
+ },
18132
+ "token_type": {
18133
+ "type": "string"
18134
+ },
18135
+ "expires_in": {
18136
+ "type": "integer"
18137
+ },
18138
+ "refresh_token": {
18139
+ "type": "string"
18140
+ },
18141
+ "user": {
18142
+ "type": "object",
18143
+ "properties": {
18144
+ "id": {
18145
+ "type": "string"
18146
+ },
18147
+ "email": {
18148
+ "type": "string"
18149
+ },
18150
+ "email_verified": {
18151
+ "type": "boolean"
18152
+ }
18153
+ },
18154
+ "required": [
18155
+ "id",
18156
+ "email",
18157
+ "email_verified"
18158
+ ]
18159
+ }
18160
+ },
18161
+ "required": [
18162
+ "access_token",
18163
+ "token_type",
18164
+ "expires_in",
18165
+ "refresh_token",
18166
+ "user"
18167
+ ]
18168
+ }
18169
+ },
18170
+ "required": [
18171
+ "data"
18172
+ ]
18173
+ },
18174
+ "example": {
18175
+ "data": {
18176
+ "access_token": "<jwt>",
18177
+ "token_type": "Bearer",
18178
+ "expires_in": 900,
18179
+ "refresh_token": "<opaque>",
18180
+ "user": {
18181
+ "id": "018f...",
18182
+ "email": "ada@example.com",
18183
+ "email_verified": true
18184
+ }
18185
+ }
18186
+ }
18187
+ }
18188
+ }
18189
+ },
18190
+ "403": {
18191
+ "description": "passkey_account_disabled | passkey_email_unverified | passkey_user_verification_required | passkey_origin_mismatch",
18192
+ "content": {
18193
+ "application/problem+json": {
18194
+ "schema": {
18195
+ "$ref": "#/components/schemas/Problem"
18196
+ }
18197
+ }
18198
+ }
18199
+ },
18200
+ "422": {
18201
+ "description": "passkey_challenge_invalid | passkey_credential_invalid | passkey_invalid_input",
18202
+ "content": {
18203
+ "application/problem+json": {
18204
+ "schema": {
18205
+ "$ref": "#/components/schemas/Problem"
18206
+ }
18207
+ }
18208
+ }
18209
+ }
18210
+ }
18211
+ }
18212
+ },
18213
+ "/passkey/{id}": {
18214
+ "delete": {
18215
+ "operationId": "delete_passkey_DeleteEndpoint",
18216
+ "summary": "Remove a passkey",
18217
+ "tags": [
18218
+ "passkey"
18219
+ ],
18220
+ "x-polaris-effect": "destructive",
18221
+ "x-polaris-receipt": true,
18222
+ "x-polaris-plugin": "passkey",
18223
+ "x-polaris-step-up": true,
18224
+ "security": [
18225
+ {
18226
+ "bearerAuth": []
18227
+ }
18228
+ ],
18229
+ "parameters": [
18230
+ {
18231
+ "name": "id",
18232
+ "in": "path",
18233
+ "required": true,
18234
+ "schema": {
18235
+ "type": "string"
18236
+ }
18237
+ }
18238
+ ],
18239
+ "responses": {
18240
+ "200": {
18241
+ "description": "Success",
18242
+ "content": {
18243
+ "application/json": {
18244
+ "schema": {
18245
+ "type": "object",
18246
+ "properties": {
18247
+ "data": {
18248
+ "type": "object",
18249
+ "properties": {
18250
+ "status": {
18251
+ "type": "string"
18252
+ }
18253
+ },
18254
+ "required": [
18255
+ "status"
18256
+ ]
18257
+ }
18258
+ },
18259
+ "required": [
18260
+ "data"
18261
+ ]
18262
+ },
18263
+ "example": {
18264
+ "data": {
18265
+ "status": "deleted"
18266
+ }
18267
+ }
18268
+ }
18269
+ }
18270
+ },
18271
+ "401": {
18272
+ "description": "unauthorized | step_up_required",
18273
+ "content": {
18274
+ "application/problem+json": {
18275
+ "schema": {
18276
+ "$ref": "#/components/schemas/Problem"
18277
+ }
18278
+ }
18279
+ }
18280
+ },
18281
+ "404": {
18282
+ "description": "passkey_not_found",
18283
+ "content": {
18284
+ "application/problem+json": {
18285
+ "schema": {
18286
+ "$ref": "#/components/schemas/Problem"
18287
+ }
18288
+ }
18289
+ }
18290
+ },
18291
+ "409": {
18292
+ "description": "passkey_last_factor",
18293
+ "content": {
18294
+ "application/problem+json": {
18295
+ "schema": {
18296
+ "$ref": "#/components/schemas/Problem"
18297
+ }
18298
+ }
18299
+ }
18300
+ }
18301
+ }
18302
+ },
18303
+ "patch": {
18304
+ "operationId": "patch_passkey_RenameEndpoint",
18305
+ "summary": "Rename a passkey",
18306
+ "tags": [
18307
+ "passkey"
18308
+ ],
18309
+ "x-polaris-effect": "write",
18310
+ "x-polaris-receipt": true,
18311
+ "x-polaris-plugin": "passkey",
18312
+ "security": [
18313
+ {
18314
+ "bearerAuth": []
18315
+ }
18316
+ ],
18317
+ "parameters": [
18318
+ {
18319
+ "name": "id",
18320
+ "in": "path",
18321
+ "required": true,
18322
+ "schema": {
18323
+ "type": "string"
18324
+ }
18325
+ }
18326
+ ],
18327
+ "requestBody": {
18328
+ "required": true,
18329
+ "content": {
18330
+ "application/json": {
18331
+ "schema": {
18332
+ "type": "object",
18333
+ "properties": {
18334
+ "name": {
18335
+ "type": "string",
18336
+ "maxLength": 80
18337
+ }
18338
+ },
18339
+ "required": [
18340
+ "name"
18341
+ ]
18342
+ }
18343
+ }
18344
+ }
18345
+ },
18346
+ "responses": {
18347
+ "200": {
18348
+ "description": "Success",
18349
+ "content": {
18350
+ "application/json": {
18351
+ "schema": {
18352
+ "type": "object",
18353
+ "properties": {
18354
+ "data": {
18355
+ "type": "object",
18356
+ "properties": {
18357
+ "id": {
18358
+ "type": "string"
18359
+ },
18360
+ "name": {
18361
+ "type": "string"
18362
+ },
18363
+ "aaguid": {
18364
+ "type": "string"
18365
+ },
18366
+ "transports": {
18367
+ "type": "array",
18368
+ "items": {
18369
+ "type": "string"
18370
+ }
18371
+ },
18372
+ "backed_up": {
18373
+ "type": "boolean"
18374
+ },
18375
+ "factor_id": {
18376
+ "type": "string"
18377
+ },
18378
+ "last_used_at": {
18379
+ "type": [
18380
+ "string",
18381
+ "null"
18382
+ ]
18383
+ },
18384
+ "created_at": {
18385
+ "type": "string"
18386
+ }
18387
+ },
18388
+ "required": [
18389
+ "id",
18390
+ "name",
18391
+ "aaguid",
18392
+ "transports",
18393
+ "backed_up",
18394
+ "factor_id",
18395
+ "last_used_at",
18396
+ "created_at"
18397
+ ]
18398
+ }
18399
+ },
18400
+ "required": [
18401
+ "data"
18402
+ ]
18403
+ },
18404
+ "example": {
18405
+ "data": {
18406
+ "id": "018f...",
18407
+ "name": "Work laptop",
18408
+ "aaguid": "<uuid>",
18409
+ "transports": [
18410
+ "internal"
18411
+ ],
18412
+ "backed_up": true,
18413
+ "factor_id": "018f...",
18414
+ "last_used_at": null,
18415
+ "created_at": "2026-10-09T10:00:00+00:00"
18416
+ }
18417
+ }
18418
+ }
18419
+ }
18420
+ },
18421
+ "401": {
18422
+ "description": "unauthorized",
18423
+ "content": {
18424
+ "application/problem+json": {
18425
+ "schema": {
18426
+ "$ref": "#/components/schemas/Problem"
18427
+ }
18428
+ }
18429
+ }
18430
+ },
18431
+ "404": {
18432
+ "description": "passkey_not_found",
18433
+ "content": {
18434
+ "application/problem+json": {
18435
+ "schema": {
18436
+ "$ref": "#/components/schemas/Problem"
18437
+ }
18438
+ }
18439
+ }
18440
+ },
18441
+ "422": {
18442
+ "description": "passkey_invalid_input",
18443
+ "content": {
18444
+ "application/problem+json": {
18445
+ "schema": {
18446
+ "$ref": "#/components/schemas/Problem"
18447
+ }
18448
+ }
18449
+ }
18450
+ }
18451
+ }
18452
+ }
18453
+ },
18454
+ "/passkey/list": {
18455
+ "get": {
18456
+ "operationId": "get_passkey_ListEndpoint",
18457
+ "summary": "List your passkeys",
18458
+ "tags": [
18459
+ "passkey"
18460
+ ],
18461
+ "x-polaris-effect": "read",
18462
+ "x-polaris-receipt": false,
18463
+ "x-polaris-plugin": "passkey",
18464
+ "security": [
18465
+ {
18466
+ "bearerAuth": []
18467
+ }
18468
+ ],
18469
+ "responses": {
18470
+ "200": {
18471
+ "description": "Success",
18472
+ "content": {
18473
+ "application/json": {
18474
+ "schema": {
18475
+ "type": "object",
18476
+ "properties": {
18477
+ "data": {
18478
+ "type": "array",
18479
+ "items": {
18480
+ "type": "object",
18481
+ "properties": {
18482
+ "id": {
18483
+ "type": "string"
18484
+ },
18485
+ "name": {
18486
+ "type": "string"
18487
+ },
18488
+ "aaguid": {
18489
+ "type": "string"
18490
+ },
18491
+ "transports": {
18492
+ "type": "array",
18493
+ "items": {
18494
+ "type": "string"
18495
+ }
18496
+ },
18497
+ "backed_up": {
18498
+ "type": "boolean"
18499
+ },
18500
+ "factor_id": {
18501
+ "type": "string"
18502
+ },
18503
+ "last_used_at": {
18504
+ "type": "string"
18505
+ },
18506
+ "created_at": {
18507
+ "type": "string"
18508
+ }
18509
+ },
18510
+ "required": [
18511
+ "id",
18512
+ "name",
18513
+ "aaguid",
18514
+ "transports",
18515
+ "backed_up",
18516
+ "factor_id",
18517
+ "last_used_at",
18518
+ "created_at"
18519
+ ]
18520
+ }
18521
+ }
18522
+ },
18523
+ "required": [
18524
+ "data"
18525
+ ]
18526
+ },
18527
+ "example": {
18528
+ "data": [
18529
+ {
18530
+ "id": "018f...",
18531
+ "name": "MacBook",
18532
+ "aaguid": "<uuid>",
18533
+ "transports": [
18534
+ "internal",
18535
+ "hybrid"
18536
+ ],
18537
+ "backed_up": true,
18538
+ "factor_id": "018f...",
18539
+ "last_used_at": "2026-10-09T10:05:00+00:00",
18540
+ "created_at": "2026-10-09T10:00:00+00:00"
18541
+ }
18542
+ ]
18543
+ }
18544
+ }
18545
+ }
18546
+ },
18547
+ "401": {
18548
+ "description": "unauthorized",
18549
+ "content": {
18550
+ "application/problem+json": {
18551
+ "schema": {
18552
+ "$ref": "#/components/schemas/Problem"
18553
+ }
18554
+ }
18555
+ }
18556
+ }
18557
+ }
18558
+ }
18559
+ },
18560
+ "/passkey/register/options": {
18561
+ "post": {
18562
+ "operationId": "post_passkey_RegisterOptionsEndpoint",
18563
+ "summary": "Start registering a passkey",
18564
+ "tags": [
18565
+ "passkey"
18566
+ ],
18567
+ "x-polaris-effect": "write",
18568
+ "x-polaris-receipt": false,
18569
+ "x-polaris-plugin": "passkey",
18570
+ "x-polaris-rate-limit": "mfa_enroll",
18571
+ "x-polaris-step-up": true,
18572
+ "security": [
18573
+ {
18574
+ "bearerAuth": []
18575
+ }
18576
+ ],
18577
+ "responses": {
18578
+ "200": {
18579
+ "description": "Success",
18580
+ "content": {
18581
+ "application/json": {
18582
+ "schema": {
18583
+ "type": "object",
18584
+ "properties": {
18585
+ "data": {
18586
+ "type": "object",
18587
+ "properties": {
18588
+ "rp": {
18589
+ "type": "object",
18590
+ "properties": {
18591
+ "id": {
18592
+ "type": "string"
18593
+ },
18594
+ "name": {
18595
+ "type": "string"
18596
+ }
18597
+ },
18598
+ "required": [
18599
+ "id",
18600
+ "name"
18601
+ ]
18602
+ },
18603
+ "user": {
18604
+ "type": "object",
18605
+ "properties": {
18606
+ "id": {
18607
+ "type": "string"
18608
+ },
18609
+ "name": {
18610
+ "type": "string"
18611
+ },
18612
+ "displayName": {
18613
+ "type": "string"
18614
+ }
18615
+ },
18616
+ "required": [
18617
+ "id",
18618
+ "name",
18619
+ "displayName"
18620
+ ]
18621
+ },
18622
+ "challenge": {
18623
+ "type": "string"
18624
+ },
18625
+ "pubKeyCredParams": {
18626
+ "type": "array",
18627
+ "items": {
18628
+ "type": "object",
18629
+ "properties": {
18630
+ "type": {
18631
+ "type": "string"
18632
+ },
18633
+ "alg": {
18634
+ "type": "integer"
18635
+ }
18636
+ },
18637
+ "required": [
18638
+ "type",
18639
+ "alg"
18640
+ ]
18641
+ }
18642
+ },
18643
+ "authenticatorSelection": {
18644
+ "type": "object",
18645
+ "properties": {
18646
+ "residentKey": {
18647
+ "type": "string"
18648
+ },
18649
+ "userVerification": {
18650
+ "type": "string"
18651
+ }
18652
+ },
18653
+ "required": [
18654
+ "residentKey",
18655
+ "userVerification"
18656
+ ]
18657
+ },
18658
+ "attestation": {
18659
+ "type": "string"
18660
+ },
18661
+ "excludeCredentials": {
18662
+ "type": "array",
18663
+ "items": []
18664
+ },
18665
+ "timeout": {
18666
+ "type": "integer"
18667
+ }
18668
+ },
18669
+ "required": [
18670
+ "rp",
18671
+ "user",
18672
+ "challenge",
18673
+ "pubKeyCredParams",
18674
+ "authenticatorSelection",
18675
+ "attestation",
18676
+ "excludeCredentials",
18677
+ "timeout"
18678
+ ]
18679
+ }
18680
+ },
18681
+ "required": [
18682
+ "data"
18683
+ ]
18684
+ },
18685
+ "example": {
18686
+ "data": {
18687
+ "rp": {
18688
+ "id": "app.example.com",
18689
+ "name": "App"
18690
+ },
18691
+ "user": {
18692
+ "id": "<opaque>",
18693
+ "name": "ada@example.com",
18694
+ "displayName": "Ada"
18695
+ },
18696
+ "challenge": "<opaque>",
18697
+ "pubKeyCredParams": [
18698
+ {
18699
+ "type": "public-key",
18700
+ "alg": -7
18701
+ },
18702
+ {
18703
+ "type": "public-key",
18704
+ "alg": -257
18705
+ }
18706
+ ],
18707
+ "authenticatorSelection": {
18708
+ "residentKey": "required",
18709
+ "userVerification": "preferred"
18710
+ },
18711
+ "attestation": "none",
18712
+ "excludeCredentials": [],
18713
+ "timeout": 60000
18714
+ }
18715
+ }
18716
+ }
18717
+ }
18718
+ },
18719
+ "401": {
18720
+ "description": "unauthorized | step_up_required",
18721
+ "content": {
18722
+ "application/problem+json": {
18723
+ "schema": {
18724
+ "$ref": "#/components/schemas/Problem"
18725
+ }
18726
+ }
18727
+ }
18728
+ }
18729
+ }
18730
+ }
18731
+ },
18732
+ "/passkey/register/verify": {
18733
+ "post": {
18734
+ "operationId": "post_passkey_RegisterVerifyEndpoint",
18735
+ "summary": "Finish registering a passkey",
18736
+ "tags": [
18737
+ "passkey"
18738
+ ],
18739
+ "x-polaris-effect": "write",
18740
+ "x-polaris-receipt": true,
18741
+ "x-polaris-plugin": "passkey",
18742
+ "x-polaris-rate-limit": "mfa_confirm",
18743
+ "x-polaris-step-up": true,
18744
+ "security": [
18745
+ {
18746
+ "bearerAuth": []
18747
+ }
18748
+ ],
18749
+ "requestBody": {
18750
+ "required": true,
18751
+ "content": {
18752
+ "application/json": {
18753
+ "schema": {
18754
+ "type": "object",
18755
+ "properties": {
18756
+ "credential": {
18757
+ "type": "object",
18758
+ "additionalProperties": true
18759
+ },
18760
+ "name": {
18761
+ "type": "string",
18762
+ "maxLength": 80
18763
+ }
18764
+ },
18765
+ "required": [
18766
+ "credential"
18767
+ ]
18768
+ }
18769
+ }
18770
+ }
18771
+ },
18772
+ "responses": {
18773
+ "201": {
18774
+ "description": "Success",
18775
+ "content": {
18776
+ "application/json": {
18777
+ "schema": {
18778
+ "type": "object",
18779
+ "properties": {
18780
+ "data": {
18781
+ "type": "object",
18782
+ "properties": {
18783
+ "passkey": {
18784
+ "type": "object",
18785
+ "properties": {
18786
+ "id": {
18787
+ "type": "string"
18788
+ },
18789
+ "name": {
18790
+ "type": "string"
18791
+ },
18792
+ "aaguid": {
18793
+ "type": "string"
18794
+ },
18795
+ "transports": {
18796
+ "type": "array",
18797
+ "items": {
18798
+ "type": "string"
18799
+ }
18800
+ },
18801
+ "backed_up": {
18802
+ "type": "boolean"
18803
+ },
18804
+ "factor_id": {
18805
+ "type": "string"
18806
+ },
18807
+ "last_used_at": {
18808
+ "type": [
18809
+ "string",
18810
+ "null"
18811
+ ]
18812
+ },
18813
+ "created_at": {
18814
+ "type": "string"
18815
+ }
18816
+ },
18817
+ "required": [
18818
+ "id",
18819
+ "name",
18820
+ "aaguid",
18821
+ "transports",
18822
+ "backed_up",
18823
+ "factor_id",
18824
+ "last_used_at",
18825
+ "created_at"
18826
+ ]
18827
+ },
18828
+ "recovery_codes": {
18829
+ "type": "array",
18830
+ "items": {
18831
+ "type": "string"
18832
+ }
18833
+ }
18834
+ },
18835
+ "required": [
18836
+ "passkey",
18837
+ "recovery_codes"
18838
+ ]
18839
+ }
18840
+ },
18841
+ "required": [
18842
+ "data"
18843
+ ]
18844
+ },
18845
+ "example": {
18846
+ "data": {
18847
+ "passkey": {
18848
+ "id": "018f...",
18849
+ "name": "MacBook",
18850
+ "aaguid": "<uuid>",
18851
+ "transports": [
18852
+ "internal",
18853
+ "hybrid"
18854
+ ],
18855
+ "backed_up": true,
18856
+ "factor_id": "018f...",
18857
+ "last_used_at": null,
18858
+ "created_at": "2026-10-09T10:00:00+00:00"
18859
+ },
18860
+ "recovery_codes": [
18861
+ "<code>",
18862
+ "<code>"
18863
+ ]
18864
+ }
18865
+ }
18866
+ }
18867
+ }
18868
+ },
18869
+ "401": {
18870
+ "description": "unauthorized | step_up_required",
18871
+ "content": {
18872
+ "application/problem+json": {
18873
+ "schema": {
18874
+ "$ref": "#/components/schemas/Problem"
18875
+ }
18876
+ }
18877
+ }
18878
+ },
18879
+ "403": {
18880
+ "description": "passkey_origin_mismatch",
18881
+ "content": {
18882
+ "application/problem+json": {
18883
+ "schema": {
18884
+ "$ref": "#/components/schemas/Problem"
18885
+ }
18886
+ }
18887
+ }
18888
+ },
18889
+ "422": {
18890
+ "description": "passkey_challenge_invalid | passkey_credential_invalid | passkey_invalid_input",
18891
+ "content": {
18892
+ "application/problem+json": {
18893
+ "schema": {
18894
+ "$ref": "#/components/schemas/Problem"
18895
+ }
18896
+ }
18897
+ }
18898
+ }
18899
+ }
18900
+ }
17013
18901
  }
17014
18902
  },
17015
18903
  "components": {