-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathSkillable-tms-OpenAPI.yaml
More file actions
11689 lines (11661 loc) · 401 KB
/
Skillable-tms-OpenAPI.yaml
File metadata and controls
11689 lines (11661 loc) · 401 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
openapi: 3.0.3
info:
title: TMS API
description: |
# Introduction
Welcome to Skillable Connect: TMS Edition, our core platform for managing your users, scheduling training to consume content, managing course assignments and subscriptions.
## Authenticate with API Key
Skillable APIs offer one form of authentication: an API Key. All methods require an API Key, which must be obtained from a Skillable team member working with your organization. Our systems use this key to validate your development account.
Pass your API Key as an HTTP request header with the header name "api_key".
<SecurityDefinitions />
termsOfService: 'https://skillable.com/terms-and-conditions/'
contact:
name: Skillable Support
url: 'https://skillable.com/customer-support/'
email: support@skillable.com
x-logo:
url: 'https://raw.githubusercontent.com/LearnOnDemandSystems/ConnectAPI/main/Skillable%20Connect%20Logo.svg'
altText: Skillable Connect
license:
name: Apache 2.0
url: 'http://www.apache.org/licenses/LICENSE-2.0.html'
version: 2.0.0
servers:
- url: 'https://lms.learnondemand.net/api/2.0'
description: Skillable Connect TMS API
security:
- api_key: []
tags:
- name: Class Enrollment Management
description: |-
Classes represent an instance of a course delivered as an instructor led event. Class enrollments define the connection of a user and the class the user will be part of. The Class Enrollment Management API allows the following tasks to be completed:
* [Create Class Enrollments for a user](https://connect.skillable.com/tms/operation/CreateClassEnrollment/)
* [Update Class Enrollments for a user](https://connect.skillable.com/tms/operation/UpdateClassEnrollment/)
* [Search for Class Enrollments for a user](https://connect.skillable.com/tms/operation/SearchClassEnrollments/)
* [Delete Class Enrollments for a user](https://connect.skillable.com/tms/operation/DeleteClassEnrollment/)
* [Retrieve specific details for Class Enrollments](https://connect.skillable.com/tms/operation/GetClassEnrollment/)
* [Retrieve Custom Fields for Class Enrollments](https://connect.skillable.com/tms/operation/GetClassEnrollmentCustomFields/)
* [Retrieve specific Custom Field values for a Class Enrollments](https://connect.skillable.com/tms/operation/GetClassEnrollmentCustomFieldValues/)
* [Update a specific Custom Field value for Class Enrollments](https://connect.skillable.com/tms/operation/UpdateClassEnrollmentCustomFieldValue/)
- name: Class Management
description: 'The Class Management group of API command allows for the creation, management and finding of scheduled classes within the Skillable TMS. Classes can be found by using Class ID''s as well as the training key associated with a class.'
- name: Company Management
description: |-
Company Management allows you to register your customers as companies. The use of companies enables you to store contact information for your customers. This information can be connected to users within the TMS, then reports can return user activity from a specific company.
* [Create a Company](https://connect.skillable.com/tms/operation/CreateCompany/)
* [Update a Company by Id](https://connect.skillable.com/tms/operation/UpdateCompany/)
* [Search for Companies](https://connect.skillable.com/tms/operation/SearchCompanies/)
* [Delete a Company by Id](https://connect.skillable.com/tms/operation/DeleteCompany/)
* [Retrieve a specific Company](https://connect.skillable.com/tms/operation/GetCompany/)
- name: Course Assignment Management
description: |-
Course Assignments are instances of a course being used for self-study purposes, and not connected with an Instructor or a class. The Course Assignment Management API group of commands allows the following capabilities:
* [Create Course Assignments for a user](https://connect.skillable.com/tms/operation/CreateCourseAssignment/)
* [Update Course Assignments for a user](https://connect.skillable.com/tms/operation/UpdateCourseAssignment/)
* [Search for Course Assignments for a user](https://connect.skillable.com/tms/operation/SearchCourseAssignments/)
* [Delete Course Assignments for a user](https://connect.skillable.com/tms/operation/DeleteCourseAssignment/)
* [Retrieve specific details for Course Assignments](https://connect.skillable.com/tms/operation/GetCourseAssignment/)
- name: Course Management
description: 'Courses in the TMS represent a related set of learning activities that create a single learning journey. The Course Management API commands allow for the searching of courses, which will be required when creating classes and/or subscriptions as well as being able to return any collected course feedback.'
- name: Lab Instance Management
description: |-
The Lab Instance Management group of API commands allows interacting with lab instances. This includes but is not limited to the following actions:
* [Find Lab Instances](https://connect.skillable.com/tms/operation/SearchLabInstances/) (Lab Instances represent individual Lab launches against the LOD platform)
* [Retrieve information about lab instances](https://connect.skillable.com/tms/operation/GetLabInstanceDetails/)
- name: Organization Management
description: 'Organizations within the TMS provide the ability to separate content and access between different customers. For most customers there is little need for Organization Management using the API. However, for large content providers Organization Management can be vital. The Organization Management of the TMS allows for the query, creation, modification, and deletion of Organizations.'
- name: Searching
description: |-
The Searching API comand group provides commands for the following scenarios:
* [To search the TMS Course Catalog Search history](https://connect.skillable.com/tms/operation/SearchCourseCatalogSearchHistory/)
* [Search for launched activities external to LOD](https://connect.skillable.com/tms/operation/SearchCourseExternalActivityLaunches/) (e.g. Video, documents, SCORM, etc)
- name: Subscription Management
description: |-
Subscriptions (previously known as Clubs), are mostly used for the assignment of self-study learning. The Subscription Management section allows the creation and management of these subscription assignments to users. The functions are grouped into the areas of:
* [Creations of Subscription Assignments](https://connect.skillable.com/tms/operation/CreateClubMembership/)
* [Searching for Subscriptions Assignments](https://connect.skillable.com/tms/operation/SearchClubMemberships/)
* [Modify a Subscriptions Assignments](https://connect.skillable.com/tms/operation/UpdateClubMembership/)
* [Delete a Subscriptions Assignments](https://connect.skillable.com/tms/operation/DeleteClubMembership/)
- name: Survey Management
description: Survey Management allows the retrival of all survey responses for a specific course.
- name: User Management
description: |-
The User Management API commands are used to administer all types of user accounts within the TMS. This includes but is not limited to the following actions:
* [Create user accounts](https://connect.skillable.com/tms/operation/CreateUser/)
* [Modify user accounts](https://connect.skillable.com/tms/operation/UpdateUser/)
* [Closure and deletion of user accounts](https://connect.skillable.com/tms/operation/DeleteUser/)
* [Retrieve user accounts properties](https://connect.skillable.com/tms/operation/GetUser/)
* [Query user activity](https://connect.skillable.com/tms/operation/SearchUserActivity/)
paths:
'/GetUser/{id}':
get:
tags:
- User Management
summary: Retrieve user information by id
description: Allows you to get information about a user (user object) with the given ID.
operationId: GetUser
parameters:
- name: id
in: path
description: The ID of the user to retrieve
required: true
style: simple
explode: true
schema:
type: integer
format: int32
responses:
'200':
description: OK Response
content:
application/json:
schema:
$ref: '#/components/schemas/UserResponse'
deprecated: false
/GetUserByEmail:
get:
tags:
- User Management
summary: Retrieve user information by email address
description: Allows you to get information about a user with the given primary email address.
operationId: GetUserByEmail
parameters:
- name: email
in: query
description: The primary email address of the user to retrieve.
required: true
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK Response
content:
application/json:
schema:
$ref: '#/components/schemas/UserResponse'
deprecated: false
'/GetUserByExternalId/{id}':
get:
tags:
- User Management
summary: Retrieve user information using an external platform id
description: Allows you to get information about a user with the given ExternalID. The external ID is a unique identifier from your external system.
operationId: GetUserByExternalId
parameters:
- name: id
in: path
description: The external ID of the user to retrieve.
required: true
style: simple
explode: true
schema:
type: string
example: C9876ZFGEFER9876
responses:
'200':
description: OK Response
content:
application/json:
schema:
$ref: '#/components/schemas/UserResponse'
deprecated: false
/CreateUser:
get:
tags:
- User Management
summary: Create a user
description: Allows you to create a user.
operationId: CreateUser
parameters:
- name: userName
in: query
description: 'The user''s username (used during sign-in). Email address can be used as long as it is unique within the system. Note: even if the user will be using an external authentication provider, the username/password properties should still be provided.'
required: true
style: form
explode: true
schema:
type: string
example: john.smith
- name: password
in: query
description: 'The user''s password (used during sign-in). Note: even if the user will be using an external authentication provider, the username/password properties should still be provided. The user will be prompted to reset their password on the next sign in.'
required: true
style: form
explode: true
schema:
type: string
- name: email
in: query
description: The user's e-mail address
required: true
style: form
explode: true
schema:
type: string
- name: firstName
in: query
description: The user's first name
required: true
style: form
explode: true
schema:
type: string
- name: lastName
in: query
description: The user's last name
required: true
style: form
explode: true
schema:
type: string
- name: organizationId
in: query
description: 'The unique identifier of the organization the user belongs to. This can be the organization that corresponds to your API key, or a child organization.'
required: true
style: form
explode: true
schema:
type: integer
format: int32
example: 12345678
- name: externalId
in: query
description: 'The user''s external ID, usually a unique identifier from the calling system'
required: false
style: form
explode: true
schema:
type: string
- name: middleName
in: query
description: The user's middle name
required: false
style: form
explode: true
schema:
type: string
- name: title
in: query
description: The user's title.
required: false
style: form
explode: true
schema:
type: string
- name: companyId
in: query
description: The Id of the user's company (set only if the user belongs to a company).
required: false
style: form
explode: true
schema:
type: integer
format: int32
example: 12345678
- name: managerId
in: query
description: The user Id of the user's manager (set only if the user belongs to a manager).
required: false
style: form
explode: true
schema:
type: integer
format: int32
example: 12345678
- name: disabled
in: query
description: Indicates whether the user account has been disabled.
required: false
style: form
explode: true
schema:
type: boolean
example: false
- name: phone
in: query
description: The user's phone number.
required: false
style: form
explode: true
schema:
type: string
- name: phone2
in: query
description: The user's secondary phone number.
required: false
style: form
explode: true
schema:
type: string
- name: address1
in: query
description: First line of the user's address.
required: false
style: form
explode: true
schema:
type: string
- name: address2
in: query
description: Second line of the user's address
required: false
style: form
explode: true
schema:
type: string
- name: city
in: query
description: The user's city.
required: false
style: form
explode: true
schema:
type: string
- name: state
in: query
description: The user's state.
required: false
style: form
explode: true
schema:
type: string
- name: country
in: query
description: The user's country. The CountryCode field will override this value if both are provided.
required: false
style: form
explode: true
schema:
type: string
deprecated: true
- name: countryCode
in: query
description: "The input field, **Country**, has been *deprecated* in favor of **CountryCode**. If the **Country** field is provided but the **CountryCode** field is not then **CountryCode** will be defaulted to **OT - Other**. \nThe **CountryCode** field is a 2-character code for the user's country. \n\n**Allowed values** \n\n OT Other - The **Country** field must be provided \n AF\tAfghanistan \n AX\tÅland Islands \n AL\tAlbania \n DZ\tAlgeria \n AS\tAmerican Samoa \n AD\tAndorra \n AO\tAngola \n AI\tAnguilla \n AG\tAntigua and Barbuda \n AR\tArgentina \n AM\tArmenia \n AW\tAruba \n AU\tAustralia \n AT\tAustria \n AZ\tAzerbaijan \n BS\tBahamas \n BH\tBahrain \n BD\tBangladesh \n BB\tBarbados \n BY\tBelarus \n BE\tBelgium \n BZ\tBelize \n BJ\tBenin \n BM\tBermuda \n BT\tBhutan \n BO\tBolivia \n BQ\tBonaire, Sint Eustatius and Saba \n BA\tBosnia and Herzegovina \n BW\tBotswana \n BR\tBrazil \n IO\tBritish Indian Ocean Territory \n VG\tBritish Virgin Islands \n BN\tBrunei \n BG\tBulgaria \n BF\tBurkina Faso \n BI\tBurundi \n CV\tCabo Verde \n KH\tCambodia \n CM\tCameroon \n CA\tCanada \n KY\tCayman Islands \n CF\tCentral African Republic \n TD\tChad \n CL\tChile \n CN\tChina \n CX\tChristmas Island \n CC\tCocos (Keeling) Islands \n CO\tColombia \n KM\tComoros \n CG\tCongo \n CD\tCongo (DRC) \n CK\tCook Islands \n CR\tCosta Rica \n CI\tCôte d’Ivoire \n HR\tCroatia \n CU\tCuba \n CW\tCuraçao \n CY\tCyprus \n CZ\tCzech Republic \n DK\tDenmark \n DJ\tDjibouti \n DM\tDominica \n DO\tDominican Republic \n EC\tEcuador \n EG\tEgypt \n SV\tEl Salvador \n GQ\tEquatorial Guinea \n ER\tEritrea \n EE\tEstonia \n ET\tEthiopia \n FK\tFalkland Islands \n FO\tFaroe Islands \n FJ\tFiji \n FI\tFinland \n FR\tFrance \n GF\tFrench Guiana \n PF\tFrench Polynesia \n GA\tGabon \n GM\tGambia \n GE\tGeorgia \n DE\tGermany \n GH\tGhana \n GI\tGibraltar \n GR\tGreece \n GL\tGreenland \n GD\tGrenada \n GP\tGuadeloupe \n GU\tGuam \n GT\tGuatemala \n GG\tGuernsey \n GN\tGuinea \n GW\tGuinea-Bissau \n GY\tGuyana \n HT\tHaiti \n HN\tHonduras \n HK\tHong Kong SAR \n HU\tHungary \n IS\tIceland \n IN\tIndia \n ID\tIndonesia \n IR\tIran \n IQ\tIraq \n IE\tIreland \n IM\tIsle of Man \n IL\tIsrael \n IT\tItaly \n JM\tJamaica \n JP\tJapan \n JE\tJersey \n JO\tJordan \n KZ\tKazakhstan \n KE\tKenya \n KI\tKiribati \n KR\tKorea \n XK\tKosovo \n KW\tKuwait \n KG\tKyrgyzstan \n LA\tLaos \n LV\tLatvia \n LB\tLebanon \n LS\tLesotho \n LR\tLiberia \n LY\tLibya \n LI\tLiechtenstein \n LT\tLithuania \n LU\tLuxembourg \n MO\tMacao SAR \n MK\tMacedonia, FYRO \n MG\tMadagascar \n MW\tMalawi \n MY\tMalaysia \n MV\tMaldives \n ML\tMali \n MT\tMalta \n MH\tMarshall Islands \n MQ\tMartinique \n MR\tMauritania \n MU\tMauritius \n YT\tMayotte \n MX\tMexico \n FM\tMicronesia \n MD\tMoldova \n MC\tMonaco \n MN\tMongolia \n ME\tMontenegro \n MS\tMontserrat \n MA\tMorocco \n MZ\tMozambique \n MM\tMyanmar \n NA\tNamibia \n NR\tNauru \n NP\tNepal \n NL\tNetherlands \n NC\tNew Caledonia \n NZ\tNew Zealand \n NI\tNicaragua \n NE\tNiger \n NG\tNigeria \n NU\tNiue \n NF\tNorfolk Island \n KP\tNorth Korea \n MP\tNorthern Mariana Islands \n NO\tNorway \n OM\tOman \n PK\tPakistan \n PW\tPalau \n PS\tPalestinian Authority \n PA\tPanama \n PG\tPapua New Guinea \n PY\tParaguay \n PE\tPeru \n PH\tPhilippines \n PN\tPitcairn Islands \n PL\tPoland \n PT\tPortugal \n PR\tPuerto Rico \n QA\tQatar \n RE\tRéunion \n RO\tRomania \n RU\tRussia \n RW\tRwanda \n BL\tSaint Barthélemy \n KN\tSaint Kitts and Nevis \n LC\tSaint Lucia \n MF\tSaint Martin \n PM\tSaint Pierre and Miquelon \n VC\tSaint Vincent and the Grenadines \n WS\tSamoa \n SM\tSan Marino \n ST\tSão Tomé and Príncipe \n SA\tSaudi Arabia \n SN\tSenegal \n RS\tSerbia \n SC\tSeychelles \n SL\tSierra Leone \n SG\tSingapore \n SX\tSint Maarten \n SK\tSlovakia \n SI\tSlovenia \n SB\tSolomon Islands \n SO\tSomalia \n ZA\tSouth Africa \n SS\tSouth Sudan \n ES\tSpain \n LK\tSri Lanka \n SH\tSt Helena, Ascension, Tristan da Cunha \n SD\tSudan \n SR\tSuriname \n SJ\tSvalbard and Jan Mayen \n SZ\tSwaziland \n SE\tSweden \n CH\tSwitzerland \n SY\tSyria \n TW\tTaiwan \n TJ\tTajikistan \n TZ\tTanzania \n TH\tThailand \n TL\tTimor-Leste \n TG\tTogo \n TK\tTokelau \n TO\tTonga \n TT\tTrinidad and Tobago \n TN\tTunisia \n TR\tTurkey \n TM\tTurkmenistan \n TC\tTurks and Caicos Islands \n TV\tTuvalu \n UM\tU.S. Outlying Islands \n VI\tU.S. Virgin Islands \n UG\tUganda \n UA\tUkraine \n AE\tUnited Arab Emirates \n GB\tUnited Kingdom \n US\tUnited States \n UY\tUruguay \n UZ\tUzbekistan \n VU\tVanuatu \n VE\tVenezuela \n VN\tVietnam \n WF\tWallis and Futuna \n YE\tYemen \n ZM\tZambia \n ZW\tZimbabwe\n"
required: false
style: form
explode: true
schema:
type: string
- name: zip
in: query
description: The user's zip/postal code.
required: false
style: form
explode: true
schema:
type: string
- name: profileImageUrl
in: query
description: URL to the user's profile image.
required: false
style: form
explode: true
schema:
type: string
- name: timeZoneId
in: query
description: |-
The time zone for the data object. If not specified, the timezone of the organization will be used.
**Allowed values**
Afghanistan Standard Time
Alaskan Standard Time
Aleutian Standard Time
Altai Standard Time
Arab Standard Time
Arabian Standard Time
Arabic Standard Time
Argentina Standard Time
Astrakhan Standard Time
Atlantic Standard Time
AUS Central Standard Time
Aus Central W. Standard Time
AUS Eastern Standard Time
Azerbaijan Standard Time
Azores Standard Time
Bahia Standard Time
Bangladesh Standard Time
Belarus Standard Time
Bougainville Standard Time
Canada Central Standard Time
Cape Verde Standard Time
Caucasus Standard Time
Cen. Australia Standard Time
Central America Standard Time
Central Asia Standard Time
Central Brazilian Standard Time
Central Europe Standard Time
Central European Standard Time
Central Pacific Standard Time
Central Standard Time
Central Standard Time (Mexico)
Chatham Islands Standard Time
China Standard Time
Cuba Standard Time
Dateline Standard Time
E. Africa Standard Time
E. Australia Standard Time
E. Europe Standard Time
E. South America Standard Time
Easter Island Standard Time
Eastern Standard Time
Eastern Standard Time (Mexico)
Egypt Standard Time
Ekaterinburg Standard Time
Fiji Standard Time
FLE Standard Time
Georgian Standard Time
GMT Standard Time
Greenland Standard Time
Greenwich Standard Time
GTB Standard Time
Haiti Standard Time
Hawaiian Standard Time
India Standard Time
Iran Standard Time
Israel Standard Time
Jordan Standard Time
Kaliningrad Standard Time
Kamchatka Standard Time
Korea Standard Time
Libya Standard Time
Line Islands Standard Time
Lord Howe Standard Time
Magadan Standard Time
Magallanes Standard Time
Marquesas Standard Time
Mauritius Standard Time
Mid-Atlantic Standard Time
Middle East Standard Time
Montevideo Standard Time
Morocco Standard Time
Mountain Standard Time
Mountain Standard Time (Mexico)
Myanmar Standard Time
N. Central Asia Standard Time
Namibia Standard Time
Nepal Standard Time
New Zealand Standard Time
Newfoundland Standard Time
Norfolk Standard Time
North Asia East Standard Time
North Asia Standard Time
North Korea Standard Time
Omsk Standard Time
Pacific SA Standard Time
Pacific Standard Time
Pacific Standard Time (Mexico)
Pakistan Standard Time
Paraguay Standard Time
Qyzylorda Standard Time
Romance Standard Time
Russia Time Zone 10
Russia Time Zone 11
Russia Time Zone 3
Russian Standard Time
SA Eastern Standard Time
SA Pacific Standard Time
SA Western Standard Time
Saint Pierre Standard Time
Sakhalin Standard Time
Samoa Standard Time
Sao Tome Standard Time
Saratov Standard Time
SE Asia Standard Time
Singapore Standard Time
South Africa Standard Time
South Sudan Standard Time
Sri Lanka Standard Time
Sudan Standard Time
Syria Standard Time
Taipei Standard Time
Tasmania Standard Time
Tocantins Standard Time
Tokyo Standard Time
Tomsk Standard Time
Tonga Standard Time
Transbaikal Standard Time
Turkey Standard Time
Turks And Caicos Standard Time
Ulaanbaatar Standard Time
US Eastern Standard Time
US Mountain Standard Time
UTC
UTC+12
UTC+13
UTC-02
UTC-08
UTC-09
UTC-11
Venezuela Standard Time
Vladivostok Standard Time
Volgograd Standard Time
W. Australia Standard Time
W. Central Africa Standard Time
W. Europe Standard Time
W. Mongolia Standard Time
West Asia Standard Time
West Bank Standard Time
West Pacific Standard Time
Yakutsk Standard Time
Yukon Standard Time
required: false
style: form
explode: true
schema:
type: string
- name: roleId
in: query
description: 'An identifier for the role the user should belong to. You can provide multiple instances of this parameter to add the user to multiple roles. For example: roleId=0&roleId=2&roleId=20. You can discover roles available to your API integration by using the GetUserRoles command.'
required: false
style: form
explode: true
schema:
type: integer
format: int32
example: 12345678
- name: managedOrganizationId
in: query
description: 'An identifier for the organization the user should have management rights for. You can provide multiple instances of this parameter if the user should have management rights over multiple organizations. For example: managedOrganizationId=30&managedOrganizationId=45&managedOrganizationId=78. All managed organizations must belong to the API caller''s organization or one of its children.'
required: false
style: form
explode: true
schema:
type: integer
format: int32
example: 12345678
- name: enableGeneralNotifications
in: query
description: An optional parameter to allow the sending of general notifications to the user.
required: false
style: form
explode: true
schema:
type: boolean
- name: forcePasswordChange
in: query
description: An optional parameter to force the user to change their password on the next login
required: false
style: form
explode: true
schema:
type: boolean
responses:
'200':
description: OK Response
content:
application/json:
schema:
$ref: '#/components/schemas/CreateResponse'
deprecated: false
'/DeleteUser/{id}':
get:
tags:
- User Management
summary: Delete a user by id
description: Allows you to delete a user.
operationId: DeleteUser
parameters:
- name: id
in: path
description: The user's ID
required: true
style: simple
explode: true
schema:
type: integer
format: int32
example: 57383
responses:
'200':
description: OK Response
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResponse'
deprecated: false
/UpdateUser:
get:
tags:
- User Management
summary: Update a user by id
description: Allows you to update a user
operationId: UpdateUser
parameters:
- name: id
in: query
description: The user's ID.
required: true
style: form
explode: true
schema:
type: integer
format: int32
example: 4873
- name: userName
in: query
description: 'The user''s username (used during sign-in). Email address can be used as long as it is unique within the system. Note: even if the user will be using an external authentication provider, the username/password properties should still be provided.'
required: true
style: form
explode: true
schema:
type: string
- name: email
in: query
description: The user's e-mail address
required: true
style: form
explode: true
schema:
type: string
- name: firstName
in: query
description: The user's first name
required: true
style: form
explode: true
schema:
type: string
- name: lastName
in: query
description: The user's last name
required: true
style: form
explode: true
schema:
type: string
- name: organizationId
in: query
description: 'The unique identifier of the organization the user belongs to. This can be the organization that corresponds to your API key, or a child organization.'
required: true
style: form
explode: true
schema:
type: integer
format: int32
example: 12345678
- name: externalId
in: query
description: 'The user''s external ID, usually a unique identifier from the calling system'
required: false
style: form
explode: true
schema:
type: string
- name: middleName
in: query
description: The user's middle name
required: false
style: form
explode: true
schema:
type: string
- name: title
in: query
description: The user's title.
required: false
style: form
explode: true
schema:
type: string
- name: companyId
in: query
description: The Id of the user's company (set only if the user belongs to a company).
required: false
style: form
explode: true
schema:
type: integer
format: int32
example: 12345678
- name: managerId
in: query
description: The user Id of the user's manager (set only if the user belongs to a manager).
required: false
style: form
explode: true
schema:
type: integer
format: int32
example: 12345678
- name: disabled
in: query
description: Indicates whether the user account has been disabled.
required: false
style: form
explode: true
schema:
type: boolean
- name: phone
in: query
description: The user's phone number.
required: false
style: form
explode: true
schema:
type: string
- name: phone2
in: query
description: The user's secondary phone number.
required: false
style: form
explode: true
schema:
type: string
- name: address1
in: query
description: First line of the user's address.
required: false
style: form
explode: true
schema:
type: string
- name: address2
in: query
description: Second line of the user's address
required: false
style: form
explode: true
schema:
type: string
- name: city
in: query
description: The user's city.
required: false
style: form
explode: true
schema:
type: string
- name: state
in: query
description: The user's state.
required: false
style: form
explode: true
schema:
type: string
- name: country
in: query
description: The user's country. The CountryCode field will override this value if both are provided.
required: false
style: form
explode: true
schema:
type: string
deprecated: true
- name: countryCode
in: query
description: "The input field, **Country**, has been *deprecated* in favor of **CountryCode**. If the **Country** field is provided but the **CountryCode** field is not then **CountryCode** will be defaulted to **OT - Other**. \nThe **CountryCode** field is a 2-character code for the user's country. \n\n**Allowed values** \n\n OT Other - The **Country** field must be provided \n AF\tAfghanistan \n AX\tÅland Islands \n AL\tAlbania \n DZ\tAlgeria \n AS\tAmerican Samoa \n AD\tAndorra \n AO\tAngola \n AI\tAnguilla \n AG\tAntigua and Barbuda \n AR\tArgentina \n AM\tArmenia \n AW\tAruba \n AU\tAustralia \n AT\tAustria \n AZ\tAzerbaijan \n BS\tBahamas \n BH\tBahrain \n BD\tBangladesh \n BB\tBarbados \n BY\tBelarus \n BE\tBelgium \n BZ\tBelize \n BJ\tBenin \n BM\tBermuda \n BT\tBhutan \n BO\tBolivia \n BQ\tBonaire, Sint Eustatius and Saba \n BA\tBosnia and Herzegovina \n BW\tBotswana \n BR\tBrazil \n IO\tBritish Indian Ocean Territory \n VG\tBritish Virgin Islands \n BN\tBrunei \n BG\tBulgaria \n BF\tBurkina Faso \n BI\tBurundi \n CV\tCabo Verde \n KH\tCambodia \n CM\tCameroon \n CA\tCanada \n KY\tCayman Islands \n CF\tCentral African Republic \n TD\tChad \n CL\tChile \n CN\tChina \n CX\tChristmas Island \n CC\tCocos (Keeling) Islands \n CO\tColombia \n KM\tComoros \n CG\tCongo \n CD\tCongo (DRC) \n CK\tCook Islands \n CR\tCosta Rica \n CI\tCôte d’Ivoire \n HR\tCroatia \n CU\tCuba \n CW\tCuraçao \n CY\tCyprus \n CZ\tCzech Republic \n DK\tDenmark \n DJ\tDjibouti \n DM\tDominica \n DO\tDominican Republic \n EC\tEcuador \n EG\tEgypt \n SV\tEl Salvador \n GQ\tEquatorial Guinea \n ER\tEritrea \n EE\tEstonia \n ET\tEthiopia \n FK\tFalkland Islands \n FO\tFaroe Islands \n FJ\tFiji \n FI\tFinland \n FR\tFrance \n GF\tFrench Guiana \n PF\tFrench Polynesia \n GA\tGabon \n GM\tGambia \n GE\tGeorgia \n DE\tGermany \n GH\tGhana \n GI\tGibraltar \n GR\tGreece \n GL\tGreenland \n GD\tGrenada \n GP\tGuadeloupe \n GU\tGuam \n GT\tGuatemala \n GG\tGuernsey \n GN\tGuinea \n GW\tGuinea-Bissau \n GY\tGuyana \n HT\tHaiti \n HN\tHonduras \n HK\tHong Kong SAR \n HU\tHungary \n IS\tIceland \n IN\tIndia \n ID\tIndonesia \n IR\tIran \n IQ\tIraq \n IE\tIreland \n IM\tIsle of Man \n IL\tIsrael \n IT\tItaly \n JM\tJamaica \n JP\tJapan \n JE\tJersey \n JO\tJordan \n KZ\tKazakhstan \n KE\tKenya \n KI\tKiribati \n KR\tKorea \n XK\tKosovo \n KW\tKuwait \n KG\tKyrgyzstan \n LA\tLaos \n LV\tLatvia \n LB\tLebanon \n LS\tLesotho \n LR\tLiberia \n LY\tLibya \n LI\tLiechtenstein \n LT\tLithuania \n LU\tLuxembourg \n MO\tMacao SAR \n MK\tMacedonia, FYRO \n MG\tMadagascar \n MW\tMalawi \n MY\tMalaysia \n MV\tMaldives \n ML\tMali \n MT\tMalta \n MH\tMarshall Islands \n MQ\tMartinique \n MR\tMauritania \n MU\tMauritius \n YT\tMayotte \n MX\tMexico \n FM\tMicronesia \n MD\tMoldova \n MC\tMonaco \n MN\tMongolia \n ME\tMontenegro \n MS\tMontserrat \n MA\tMorocco \n MZ\tMozambique \n MM\tMyanmar \n NA\tNamibia \n NR\tNauru \n NP\tNepal \n NL\tNetherlands \n NC\tNew Caledonia \n NZ\tNew Zealand \n NI\tNicaragua \n NE\tNiger \n NG\tNigeria \n NU\tNiue \n NF\tNorfolk Island \n KP\tNorth Korea \n MP\tNorthern Mariana Islands \n NO\tNorway \n OM\tOman \n PK\tPakistan \n PW\tPalau \n PS\tPalestinian Authority \n PA\tPanama \n PG\tPapua New Guinea \n PY\tParaguay \n PE\tPeru \n PH\tPhilippines \n PN\tPitcairn Islands \n PL\tPoland \n PT\tPortugal \n PR\tPuerto Rico \n QA\tQatar \n RE\tRéunion \n RO\tRomania \n RU\tRussia \n RW\tRwanda \n BL\tSaint Barthélemy \n KN\tSaint Kitts and Nevis \n LC\tSaint Lucia \n MF\tSaint Martin \n PM\tSaint Pierre and Miquelon \n VC\tSaint Vincent and the Grenadines \n WS\tSamoa \n SM\tSan Marino \n ST\tSão Tomé and Príncipe \n SA\tSaudi Arabia \n SN\tSenegal \n RS\tSerbia \n SC\tSeychelles \n SL\tSierra Leone \n SG\tSingapore \n SX\tSint Maarten \n SK\tSlovakia \n SI\tSlovenia \n SB\tSolomon Islands \n SO\tSomalia \n ZA\tSouth Africa \n SS\tSouth Sudan \n ES\tSpain \n LK\tSri Lanka \n SH\tSt Helena, Ascension, Tristan da Cunha \n SD\tSudan \n SR\tSuriname \n SJ\tSvalbard and Jan Mayen \n SZ\tSwaziland \n SE\tSweden \n CH\tSwitzerland \n SY\tSyria \n TW\tTaiwan \n TJ\tTajikistan \n TZ\tTanzania \n TH\tThailand \n TL\tTimor-Leste \n TG\tTogo \n TK\tTokelau \n TO\tTonga \n TT\tTrinidad and Tobago \n TN\tTunisia \n TR\tTurkey \n TM\tTurkmenistan \n TC\tTurks and Caicos Islands \n TV\tTuvalu \n UM\tU.S. Outlying Islands \n VI\tU.S. Virgin Islands \n UG\tUganda \n UA\tUkraine \n AE\tUnited Arab Emirates \n GB\tUnited Kingdom \n US\tUnited States \n UY\tUruguay \n UZ\tUzbekistan \n VU\tVanuatu \n VE\tVenezuela \n VN\tVietnam \n WF\tWallis and Futuna \n YE\tYemen \n ZM\tZambia \n ZW\tZimbabwe\n"
required: false
style: form
explode: true
schema:
type: string
- name: zip
in: query
description: The user's zip/postal code.
required: false
style: form
explode: true
schema:
type: string
- name: profileImageUrl
in: query
description: URL to the user's profile image.
required: false
style: form
explode: true
schema:
type: string
- name: timeZoneId
in: query
description: |
The user's time zone. If not specified, the timezone of the organization will be used.
**Allowed values**
Afghanistan Standard Time
Alaskan Standard Time
Aleutian Standard Time
Altai Standard Time
Arab Standard Time
Arabian Standard Time
Arabic Standard Time
Argentina Standard Time
Astrakhan Standard Time
Atlantic Standard Time
AUS Central Standard Time
Aus Central W. Standard Time
AUS Eastern Standard Time
Azerbaijan Standard Time
Azores Standard Time
Bahia Standard Time
Bangladesh Standard Time
Belarus Standard Time
Bougainville Standard Time
Canada Central Standard Time
Cape Verde Standard Time
Caucasus Standard Time
Cen. Australia Standard Time
Central America Standard Time
Central Asia Standard Time
Central Brazilian Standard Time
Central Europe Standard Time
Central European Standard Time
Central Pacific Standard Time
Central Standard Time
Central Standard Time (Mexico)
Chatham Islands Standard Time
China Standard Time
Cuba Standard Time
Dateline Standard Time
E. Africa Standard Time
E. Australia Standard Time
E. Europe Standard Time
E. South America Standard Time
Easter Island Standard Time
Eastern Standard Time
Eastern Standard Time (Mexico)
Egypt Standard Time
Ekaterinburg Standard Time
Fiji Standard Time
FLE Standard Time
Georgian Standard Time
GMT Standard Time
Greenland Standard Time
Greenwich Standard Time
GTB Standard Time
Haiti Standard Time
Hawaiian Standard Time
India Standard Time
Iran Standard Time
Israel Standard Time
Jordan Standard Time
Kaliningrad Standard Time
Kamchatka Standard Time
Korea Standard Time
Libya Standard Time
Line Islands Standard Time
Lord Howe Standard Time
Magadan Standard Time
Magallanes Standard Time
Marquesas Standard Time
Mauritius Standard Time
Mid-Atlantic Standard Time
Middle East Standard Time
Montevideo Standard Time
Morocco Standard Time
Mountain Standard Time
Mountain Standard Time (Mexico)
Myanmar Standard Time
N. Central Asia Standard Time
Namibia Standard Time
Nepal Standard Time
New Zealand Standard Time
Newfoundland Standard Time
Norfolk Standard Time
North Asia East Standard Time
North Asia Standard Time
North Korea Standard Time
Omsk Standard Time
Pacific SA Standard Time
Pacific Standard Time
Pacific Standard Time (Mexico)
Pakistan Standard Time
Paraguay Standard Time
Qyzylorda Standard Time
Romance Standard Time
Russia Time Zone 10
Russia Time Zone 11
Russia Time Zone 3
Russian Standard Time
SA Eastern Standard Time
SA Pacific Standard Time
SA Western Standard Time
Saint Pierre Standard Time
Sakhalin Standard Time
Samoa Standard Time
Sao Tome Standard Time
Saratov Standard Time
SE Asia Standard Time
Singapore Standard Time
South Africa Standard Time
South Sudan Standard Time
Sri Lanka Standard Time
Sudan Standard Time
Syria Standard Time
Taipei Standard Time
Tasmania Standard Time
Tocantins Standard Time
Tokyo Standard Time
Tomsk Standard Time
Tonga Standard Time
Transbaikal Standard Time
Turkey Standard Time
Turks And Caicos Standard Time
Ulaanbaatar Standard Time
US Eastern Standard Time
US Mountain Standard Time
UTC
UTC+12
UTC+13
UTC-02
UTC-08
UTC-09
UTC-11
Venezuela Standard Time
Vladivostok Standard Time
Volgograd Standard Time
W. Australia Standard Time
W. Central Africa Standard Time
W. Europe Standard Time
W. Mongolia Standard Time
West Asia Standard Time
West Bank Standard Time
West Pacific Standard Time
Yakutsk Standard Time
Yukon Standard Time
required: false
style: form
explode: true
schema:
type: string
- name: enableGeneralNotifications
in: query
description: An optional parameter to allow the sending of general notifications to the user.
required: false
style: form
explode: true
schema:
type: boolean
- name: forcePasswordChange
in: query
description: An optional parameter to force the user to change their password on the next login
required: false
style: form
explode: true
schema:
type: boolean
responses:
'200':
description: OK Response
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResponse'
deprecated: false
/AddUserToRole:
get:
tags:
- User Management
summary: Add a role to a user
description: Allows you to add a user to a role
operationId: AddUserToRole
parameters:
- name: userId
in: query
description: The user's ID
required: true
style: form
explode: true
schema:
type: integer
format: int32
example: 57383
- name: roleId
in: query
description: The role ID
required: true
style: form
explode: true
schema:
type: integer
format: int32
example: 20
responses:
'200':
description: OK Response
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResponse'
deprecated: false
/AddUserToRoles:
get:
tags:
- User Management
summary: Add roles to a user
description: Allows you to add a user to multiple roles
operationId: AddUserToRoles
parameters:
- name: userId
in: query
description: The user's ID