BmltClient 1.0.0

data/openapi.json

@@ -0,0 +1 @@
+{"openapi":"3.0.0","info":{"title":"BMLT","description":"BMLT Admin API Documentation","license":{"name":"MIT","url":"https://github.com/bmlt-enabled/bmlt-root-server/blob/main/LICENSE"},"version":"1.0.0"},"paths":{"/api/v1/errortest":{"post":{"tags":["rootServer"],"summary":"Tests some errors","description":"Tests some errors.","operationId":"createErrorTest","requestBody":{"description":"Pass in error test object.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorTest"}}}},"responses":{"201":{"description":"Returns when POST is successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorTest"}}}},"401":{"description":"Returns when user is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"500":{"description":"Server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServerError"}}}}},"security":[{"bmltToken":[]}]}},"/api/v1/formats":{"get":{"tags":["rootServer"],"summary":"Retrieves formats","description":"Retrieve formats","operationId":"getFormats","responses":{"200":{"description":"Returns when user is authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormatCollection"}}}},"401":{"description":"Returns when not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}}},"security":[{"bmltToken":[]}]},"post":{"tags":["rootServer"],"summary":"Creates a format","description":"Creates a format.","operationId":"createFormat","requestBody":{"description":"Pass in format object","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormatCreate"}}}},"responses":{"201":{"description":"Returns when POST is successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Format"}}}},"401":{"description":"Returns when user is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Returns when user is unauthorized to perform action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"404":{"description":"Returns when no format exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}},"security":[{"bmltToken":[]}]}},"/api/v1/formats/{formatId}":{"get":{"tags":["rootServer"],"summary":"Retrieves a format","description":"Retrieve a format","operationId":"getFormat","parameters":[{"name":"formatId","in":"path","description":"ID of format","required":true,"schema":{"type":"integer","format":"int64"},"example":"1"}],"responses":{"200":{"description":"Returns when user is authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Format"}}}},"401":{"description":"Returns when not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"404":{"description":"Returns when no format exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"security":[{"bmltToken":[]}]},"put":{"tags":["rootServer"],"summary":"Updates a format","description":"Updates a format.","operationId":"updateFormat","parameters":[{"name":"formatId","in":"path","description":"ID of format","required":true,"schema":{"type":"integer","format":"int64"},"example":"1"}],"requestBody":{"description":"Pass in format object","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormatUpdate"}}}},"responses":{"204":{"description":"Success."},"401":{"description":"Returns when user is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Returns when user is unauthorized to perform action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"404":{"description":"Returns when no format exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}},"security":[{"bmltToken":[]}]},"delete":{"tags":["rootServer"],"summary":"Deletes a format","description":"Deletes a format by id.","operationId":"deleteFormat","parameters":[{"name":"formatId","in":"path","description":"ID of format","required":true,"schema":{"type":"integer","format":"int64"},"example":"1"}],"responses":{"204":{"description":"Success."},"401":{"description":"Returns when not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Returns when unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationError"}}}},"404":{"description":"Returns when no format exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}},"security":[{"bmltToken":[]}]},"patch":{"tags":["rootServer"],"summary":"Patches a format","description":"Patches a single format by id.","operationId":"patchFormat","parameters":[{"name":"formatId","in":"path","description":"ID of format","required":true,"schema":{"type":"integer","format":"int64"},"example":"1"}],"requestBody":{"description":"Pass in fields you want to update.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormatPartialUpdate"}}}},"responses":{"204":{"description":"Success."},"401":{"description":"Returns when not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Returns when unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationError"}}}},"404":{"description":"Returns when no format exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}},"security":[{"bmltToken":[]}]}},"/api/v1/meetings":{"get":{"tags":["rootServer"],"summary":"Retrieves meetings","description":"Retrieve meetings for authenticated user.","operationId":"getMeetings","parameters":[{"name":"meetingIds","in":"query","description":"comma delimited meeting ids","required":false,"schema":{"type":"string"},"example":"1,2"},{"name":"days","in":"query","description":"comma delimited day ids between 0-6","required":false,"schema":{"type":"string"},"example":"0,1"},{"name":"serviceBodyIds","in":"query","description":"comma delimited service body ids","required":false,"schema":{"type":"string"},"example":"3,4"},{"name":"searchString","in":"query","description":"string","required":false,"schema":{"type":"string"},"example":"Just for Today"}],"responses":{"200":{"description":"List of meetings.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeetingCollection"}}}},"401":{"description":"Returns when user is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}},"security":[{"bmltToken":[]}]},"post":{"tags":["rootServer"],"summary":"Creates a meeting","description":"Creates a meeting.","operationId":"createMeeting","requestBody":{"description":"Pass in meeting object","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeetingCreate"}}}},"responses":{"201":{"description":"Returns when POST is successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Meeting"}}}},"401":{"description":"Returns when user is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Returns when user is unauthorized to perform action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationError"}}}},"404":{"description":"Returns when no meeting body exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}},"security":[{"bmltToken":[]}]}},"/api/v1/meetings/{meetingId}":{"get":{"tags":["rootServer"],"summary":"Retrieves a meeting","description":"Retrieve a meeting.","operationId":"getMeeting","parameters":[{"name":"meetingId","in":"path","description":"ID of meeting","required":true,"schema":{"type":"integer","format":"int64"},"example":"1"}],"responses":{"200":{"description":"Returns when user is authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Meeting"}}}},"401":{"description":"Returns when user is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"404":{"description":"Returns when no meeting exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"security":[{"bmltToken":[]}]},"put":{"tags":["rootServer"],"summary":"Updates a meeting","description":"Updates a meeting.","operationId":"updateMeeting","parameters":[{"name":"meetingId","in":"path","description":"ID of meeting","required":true,"schema":{"type":"integer","format":"int64"},"example":"1"}],"requestBody":{"description":"Pass in meeting object","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeetingUpdate"}}}},"responses":{"204":{"description":"Success."},"401":{"description":"Returns when user is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Returns when user is unauthorized to perform action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationError"}}}},"404":{"description":"Returns when no meeting exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}},"security":[{"bmltToken":[]}]},"delete":{"tags":["rootServer"],"summary":"Deletes a meeting","description":"Deletes a meeting by id.","operationId":"deleteMeeting","parameters":[{"name":"meetingId","in":"path","description":"ID of meeting","required":true,"schema":{"type":"integer","format":"int64"},"example":"1"}],"responses":{"204":{"description":"Success."},"401":{"description":"Returns when user is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Returns when user is unauthorized to perform action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationError"}}}},"404":{"description":"Returns when no meeting exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"security":[{"bmltToken":[]}]},"patch":{"tags":["rootServer"],"summary":"Patches a meeting","description":"Patches a meeting by id","operationId":"patchMeeting","parameters":[{"name":"meetingId","in":"path","description":"ID of meeting","required":true,"schema":{"type":"integer","format":"int64"},"example":"1"}],"requestBody":{"description":"Pass in fields you want to update.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeetingPartialUpdate"}}}},"responses":{"204":{"description":"Success."},"401":{"description":"Returns when user is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Returns when user is unauthorized to perform action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationError"}}}},"404":{"description":"Returns when no meeting exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}},"security":[{"bmltToken":[]}]}},"/api/v1/servicebodies":{"get":{"tags":["rootServer"],"summary":"Retrieves service bodies","description":"Retrieve service bodies for authenticated user.","operationId":"getServiceBodies","responses":{"200":{"description":"Returns when user is authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceBodyCollection"}}}},"401":{"description":"Returns when not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}}},"security":[{"bmltToken":[]}]},"post":{"tags":["rootServer"],"summary":"Creates a service body","description":"Creates a service body.","operationId":"createServiceBody","requestBody":{"description":"Pass in service body object","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceBodyCreate"}}}},"responses":{"201":{"description":"Returns when POST is successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceBody"}}}},"401":{"description":"Returns when user is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Returns when user is unauthorized to perform action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationError"}}}},"404":{"description":"Returns when no service body exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}},"security":[{"bmltToken":[]}]}},"/api/v1/servicebodies/{serviceBodyId}":{"get":{"tags":["rootServer"],"summary":"Retrieves a service body","description":"Retrieve a single service body by id.","operationId":"getServiceBody","parameters":[{"name":"serviceBodyId","in":"path","description":"ID of service body","required":true,"schema":{"type":"integer","format":"int64"},"example":"1"}],"responses":{"200":{"description":"Returns when user is authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceBody"}}}},"401":{"description":"Returns when user is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"404":{"description":"Returns when no service body exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"security":[{"bmltToken":[]}]},"put":{"tags":["rootServer"],"summary":"Updates a Service Body","description":"Updates a single service body.","operationId":"updateServiceBody","parameters":[{"name":"serviceBodyId","in":"path","description":"ID of service body","required":true,"schema":{"type":"integer","format":"int64"},"example":"1"}],"requestBody":{"description":"Pass in service body object","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceBodyUpdate"}}}},"responses":{"204":{"description":"Success."},"401":{"description":"Returns when user is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Returns when user is unauthorized to perform action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationError"}}}},"404":{"description":"Returns when no service body exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}},"security":[{"bmltToken":[]}]},"delete":{"tags":["rootServer"],"summary":"Deletes a service body","description":"Deletes a service body by id.","operationId":"deleteServiceBody","parameters":[{"name":"serviceBodyId","in":"path","description":"ID of service body","required":true,"schema":{"type":"integer","format":"int64"},"example":"1"}],"responses":{"204":{"description":"Success."},"401":{"description":"Returns when user is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Returns when user is unauthorized to perform action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationError"}}}},"404":{"description":"Returns when no service body exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"security":[{"bmltToken":[]}]},"patch":{"tags":["rootServer"],"summary":"Patches a service body","description":"Patches a single service body by id.","operationId":"patchServiceBody","parameters":[{"name":"serviceBodyId","in":"path","description":"ID of service body","required":true,"schema":{"type":"integer","format":"int64"},"example":"1"}],"requestBody":{"description":"Pass in fields you want to update.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceBodyPartialUpdate"}}}},"responses":{"204":{"description":"Success."},"401":{"description":"Returns when user is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Returns when user is unauthorized to perform action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationError"}}}},"404":{"description":"Returns when no service body exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}},"security":[{"bmltToken":[]}]}},"/api/v1/auth/token":{"post":{"tags":["rootServer"],"summary":"Creates a token","description":"Exchange credentials for a new token","operationId":"authToken","requestBody":{"description":"User credentials","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenCredentials"}}}},"responses":{"201":{"description":"Returns when POST is successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Token"}}}},"401":{"description":"Returns when credentials are incorrect.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}}},"/api/v1/auth/refresh":{"post":{"tags":["rootServer"],"summary":"Revokes and issues a new token","description":"Refresh token.","operationId":"authRefresh","responses":{"200":{"description":"Returns when refresh is successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Token"}}}},"401":{"description":"Returns when request is unauthenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}}},"security":[{"bmltToken":[]}]}},"/api/v1/auth/logout":{"post":{"tags":["rootServer"],"summary":"Revokes a token","description":"Revoke token and logout.","operationId":"authLogout","responses":{"200":{"description":"Returns when token was logged out."},"401":{"description":"Returns when request is unauthenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}}},"security":[{"bmltToken":[]}]}},"/api/v1/users":{"get":{"tags":["rootServer"],"summary":"Retrieves users","description":"Retrieve users for authenticated user.","operationId":"getUsers","responses":{"200":{"description":"Returns when user is authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCollection"}}}},"401":{"description":"Returns when not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}}},"security":[{"bmltToken":[]}]},"post":{"tags":["rootServer"],"summary":"Creates a user","description":"Creates a user.","operationId":"createUser","requestBody":{"description":"Pass in user object","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCreate"}}}},"responses":{"201":{"description":"Returns when POST is successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}}},"401":{"description":"Returns when user is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Returns when user is unauthorized to perform action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"404":{"description":"Returns when no user exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}},"security":[{"bmltToken":[]}]}},"/api/v1/users/{userId}":{"get":{"tags":["rootServer"],"summary":"Retrieves a single user","description":"Retrieve single user.","operationId":"getUser","parameters":[{"name":"userId","in":"path","description":"ID of user","required":true,"schema":{"type":"integer","format":"int64"},"example":"1"}],"responses":{"200":{"description":"Returns when user is authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}}},"401":{"description":"Returns when not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"404":{"description":"Returns when no user exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}}},"security":[{"bmltToken":[]}]},"put":{"tags":["rootServer"],"summary":"Update single user","description":"Updates a user.","operationId":"updateUser","parameters":[{"name":"userId","in":"path","description":"ID of user","required":true,"schema":{"type":"integer","format":"int64"},"example":"1"}],"requestBody":{"description":"Pass in user object","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserUpdate"}}}},"responses":{"204":{"description":"Success."},"401":{"description":"Returns when user is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Returns when user is unauthorized to perform action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"404":{"description":"Returns when no user exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}},"security":[{"bmltToken":[]}]},"delete":{"tags":["rootServer"],"summary":"Deletes a user","description":"Deletes a user by id","operationId":"deleteUser","parameters":[{"name":"userId","in":"path","description":"ID of user","required":true,"schema":{"type":"integer","format":"int64"},"example":"1"}],"responses":{"204":{"description":"Success."},"401":{"description":"Returns when not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Returns when unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationError"}}}},"404":{"description":"Returns when no user exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}},"security":[{"bmltToken":[]}]},"patch":{"tags":["rootServer"],"summary":"Patches a user","description":"Patches a user by id.","operationId":"partialUpdateUser","parameters":[{"name":"userId","in":"path","description":"ID of user","required":true,"schema":{"type":"integer","format":"int64"},"example":"1"}],"requestBody":{"description":"Pass in fields you want to update.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserPartialUpdate"}}}},"responses":{"204":{"description":"Success."},"401":{"description":"Returns when not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Returns when unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationError"}}}},"404":{"description":"Returns when no user exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}},"422":{"description":"Validation error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}},"security":[{"bmltToken":[]}]}}},"components":{"schemas":{"ErrorTest":{"properties":{"arbitrary_string":{"type":"string","example":"string"},"arbitrary_int":{"type":"integer","example":"123"},"force_server_error":{"type":"boolean","example":"true"}},"type":"object"},"AuthenticationError":{"required":["message"],"properties":{"message":{"type":"string","example":"Unauthenticated."}},"type":"object"},"AuthorizationError":{"required":["message"],"properties":{"message":{"type":"string","example":"This action is unauthorized."}},"type":"object"},"NotFoundError":{"required":["message"],"properties":{"message":{"type":"string","example":"The requested resource was not found."}},"type":"object"},"ValidationError":{"required":["message","errors"],"properties":{"message":{"type":"string","example":"The field is required. (and 1 more error)"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","example":"error details"}}}},"type":"object"},"ServerError":{"required":["message"],"properties":{"message":{"type":"string","example":"Server Error"}},"type":"object"},"FormatBase":{"properties":{"worldId":{"type":"string","example":"string"},"type":{"type":"string","example":"string"},"translations":{"type":"array","items":{"$ref":"#/components/schemas/FormatTranslation"}}},"type":"object"},"FormatTranslation":{"required":["key","name","description","language"],"properties":{"key":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"language":{"type":"string"}},"type":"object"},"Format":{"required":["id","worldId","type","translations"],"type":"object","allOf":[{"$ref":"#/components/schemas/FormatBase"},{"properties":{"id":{"type":"integer","example":"0"}}}]},"FormatCreate":{"required":["translations"],"allOf":[{"$ref":"#/components/schemas/FormatBase"}]},"FormatUpdate":{"required":["translations"],"allOf":[{"$ref":"#/components/schemas/FormatBase"}]},"FormatPartialUpdate":{"allOf":[{"$ref":"#/components/schemas/FormatBase"}]},"FormatCollection":{"type":"array","items":{"$ref":"#/components/schemas/Format"}},"MeetingBase":{"properties":{"serviceBodyId":{"type":"integer","example":"0"},"formatIds":{"type":"array","items":{"type":"integer"}},"venueType":{"type":"integer","example":"1"},"temporarilyVirtual":{"type":"boolean","example":"false"},"day":{"type":"integer","example":"0"},"startTime":{"type":"string","example":"string"},"duration":{"type":"string","example":"01:00"},"timeZone":{"type":"string","example":"America/New_York"},"latitude":{"type":"number","format":"float","example":"35.698741"},"longitude":{"type":"number","format":"float","example":"-81.26273"},"published":{"type":"boolean","example":"true"},"email":{"type":"string","example":"string"},"worldId":{"type":"string","example":"string"},"name":{"type":"string","example":"string"},"location_text":{"type":"string","example":"string"},"location_info":{"type":"string","example":"string"},"location_street":{"type":"string","example":"string"},"location_neighborhood":{"type":"string","example":"string"},"location_city_subsection":{"type":"string","example":"string"},"location_municipality":{"type":"string","example":"string"},"location_sub_province":{"type":"string","example":"string"},"location_province":{"type":"string","example":"string"},"location_postal_code_1":{"type":"string","example":"string"},"location_nation":{"type":"string","example":"string"},"phone_meeting_number":{"type":"string","example":"string"},"virtual_meeting_link":{"type":"string","example":"string"},"virtual_meeting_additional_info":{"type":"string","example":"string"},"contact_name_1":{"type":"string","example":"string"},"contact_name_2":{"type":"string","example":"string"},"contact_phone_1":{"type":"string","example":"string"},"contact_phone_2":{"type":"string","example":"string"},"contact_email_1":{"type":"string","example":"string"},"contact_email_2":{"type":"string","example":"string"},"bus_lines":{"type":"string","example":"string"},"train_line":{"type":"string","example":"string"},"comments":{"type":"string","example":"string"}},"type":"object"},"Meeting":{"required":["id","serviceBodyId","formatIds","venueType","temporarilyVirtual","day","startTime","duration","timeZone","latitude","longitude","published","email","worldId","name"],"type":"object","allOf":[{"$ref":"#/components/schemas/MeetingBase"},{"properties":{"id":{"type":"integer","example":"0"}}}]},"MeetingCreate":{"required":["serviceBodyId","formatIds","venueType","day","startTime","duration","latitude","longitude","published","name"],"allOf":[{"$ref":"#/components/schemas/MeetingBase"}]},"MeetingUpdate":{"required":["serviceBodyId","formatIds","venueType","day","startTime","duration","latitude","longitude","published","name"],"allOf":[{"$ref":"#/components/schemas/MeetingBase"}]},"MeetingPartialUpdate":{"required":["serviceBodyId","formatIds","venueType","day","startTime","duration","latitude","longitude","published","name"],"allOf":[{"$ref":"#/components/schemas/MeetingBase"}]},"MeetingCollection":{"type":"array","items":{"$ref":"#/components/schemas/Meeting"}},"ServiceBodyBase":{"properties":{"parentId":{"type":"integer","example":"0"},"name":{"type":"string","example":"string"},"description":{"type":"string","example":"string"},"type":{"type":"string","example":"string"},"adminUserId":{"type":"integer","example":"0"},"assignedUserIds":{"type":"array","items":{"type":"integer","example":"0"}},"url":{"type":"string","example":"string"},"helpline":{"type":"string","example":"string"},"email":{"type":"string","example":"string"},"worldId":{"type":"string","example":"string"}},"type":"object"},"ServiceBody":{"required":["id","parentId","name","description","type","adminUserId","assignedUserIds","url","helpline","email","worldId"],"type":"object","allOf":[{"$ref":"#/components/schemas/ServiceBodyBase"},{"properties":{"id":{"type":"integer","example":"0"}}}]},"ServiceBodyCreate":{"required":["parentId","name","description","type","adminUserId","assignedUserIds"],"allOf":[{"$ref":"#/components/schemas/ServiceBodyBase"}]},"ServiceBodyUpdate":{"required":["parentId","name","description","type","adminUserId","assignedUserIds"],"allOf":[{"$ref":"#/components/schemas/ServiceBodyBase"}]},"ServiceBodyPartialUpdate":{"allOf":[{"$ref":"#/components/schemas/ServiceBodyBase"}]},"ServiceBodyCollection":{"type":"array","items":{"$ref":"#/components/schemas/ServiceBody"}},"Token":{"required":["access_token","expires_at","token_type","user_id"],"properties":{"access_token":{"type":"string","example":"2|tR6PIqa8tiBJWMu4zyb3qw4eECuERjLd7xeLKgBu"},"expires_at":{"type":"integer","example":"1667342171"},"token_type":{"type":"string","example":"bearer"},"user_id":{"type":"integer","example":"1"}},"type":"object"},"TokenCredentials":{"required":["username","password"],"properties":{"password":{"type":"string","format":"password","example":"PassWord12345"},"username":{"type":"string","format":"username","example":"MyUsername"}},"type":"object"},"UserBase":{"properties":{"username":{"type":"string","example":"string"},"type":{"type":"string","example":"string"},"displayName":{"type":"string","example":"string"},"description":{"type":"string","example":"string"},"email":{"type":"string","example":"string"},"ownerId":{"type":"string","example":"0"}},"type":"object"},"User":{"required":["id","username","type","displayName","description","email","ownerId"],"type":"object","allOf":[{"$ref":"#/components/schemas/UserBase"},{"properties":{"id":{"type":"integer","example":"0"}}}]},"UserCreate":{"required":["username","password","type","displayName"],"type":"object","allOf":[{"$ref":"#/components/schemas/UserBase"},{"properties":{"password":{"type":"string","example":"string"}}}]},"UserUpdate":{"required":["username","type","displayName"],"type":"object","allOf":[{"$ref":"#/components/schemas/UserBase"},{"properties":{"password":{"type":"string","example":"string"}}}]},"UserPartialUpdate":{"type":"object","allOf":[{"$ref":"#/components/schemas/UserBase"},{"properties":{"password":{"type":"string","example":"string"}}}]},"UserCollection":{"type":"array","items":{"$ref":"#/components/schemas/User"}}},"securitySchemes":{"bmltToken":{"type":"oauth2","flows":{"password":{"tokenUrl":"api/v1/auth/token","refreshUrl":"api/v1/auth/refresh","scopes":{}}}}}},"servers":[{"url":"http://localhost:8000/main_server/","description":"this server"}]}

data/spec/api/root_server_api_spec.rb

@@ -0,0 +1,377 @@
+=begin
+#BMLT
+
+#BMLT Admin API Documentation
+
+The version of the OpenAPI document: 1.0.0
+
+Generated by: https://openapi-generator.tech
+OpenAPI Generator version: 6.2.1-SNAPSHOT
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for BmltClient::RootServerApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'RootServerApi' do
+  before do
+    # run before each test
+    @api_instance = BmltClient::RootServerApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of RootServerApi' do
+    it 'should create an instance of RootServerApi' do
+      expect(@api_instance).to be_instance_of(BmltClient::RootServerApi)
+    end
+  end
+
+  # unit tests for auth_logout
+  # Revokes a token
+  # Revoke token and logout.
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'auth_logout test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for auth_refresh
+  # Revokes and issues a new token
+  # Refresh token.
+  # @param [Hash] opts the optional parameters
+  # @return [Token]
+  describe 'auth_refresh test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for auth_token
+  # Creates a token
+  # Exchange credentials for a new token
+  # @param token_credentials User credentials
+  # @param [Hash] opts the optional parameters
+  # @return [Token]
+  describe 'auth_token test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for create_error_test
+  # Tests some errors
+  # Tests some errors.
+  # @param error_test Pass in error test object.
+  # @param [Hash] opts the optional parameters
+  # @return [ErrorTest]
+  describe 'create_error_test test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for create_format
+  # Creates a format
+  # Creates a format.
+  # @param format_create Pass in format object
+  # @param [Hash] opts the optional parameters
+  # @return [Format]
+  describe 'create_format test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for create_meeting
+  # Creates a meeting
+  # Creates a meeting.
+  # @param meeting_create Pass in meeting object
+  # @param [Hash] opts the optional parameters
+  # @return [Meeting]
+  describe 'create_meeting test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for create_service_body
+  # Creates a service body
+  # Creates a service body.
+  # @param service_body_create Pass in service body object
+  # @param [Hash] opts the optional parameters
+  # @return [ServiceBody]
+  describe 'create_service_body test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for create_user
+  # Creates a user
+  # Creates a user.
+  # @param user_create Pass in user object
+  # @param [Hash] opts the optional parameters
+  # @return [User]
+  describe 'create_user test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for delete_format
+  # Deletes a format
+  # Deletes a format by id.
+  # @param format_id ID of format
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'delete_format test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for delete_meeting
+  # Deletes a meeting
+  # Deletes a meeting by id.
+  # @param meeting_id ID of meeting
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'delete_meeting test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for delete_service_body
+  # Deletes a service body
+  # Deletes a service body by id.
+  # @param service_body_id ID of service body
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'delete_service_body test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for delete_user
+  # Deletes a user
+  # Deletes a user by id
+  # @param user_id ID of user
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'delete_user test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for get_format
+  # Retrieves a format
+  # Retrieve a format
+  # @param format_id ID of format
+  # @param [Hash] opts the optional parameters
+  # @return [Format]
+  describe 'get_format test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for get_formats
+  # Retrieves formats
+  # Retrieve formats
+  # @param [Hash] opts the optional parameters
+  # @return [Array<Format>]
+  describe 'get_formats test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for get_meeting
+  # Retrieves a meeting
+  # Retrieve a meeting.
+  # @param meeting_id ID of meeting
+  # @param [Hash] opts the optional parameters
+  # @return [Meeting]
+  describe 'get_meeting test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for get_meetings
+  # Retrieves meetings
+  # Retrieve meetings for authenticated user.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :meeting_ids comma delimited meeting ids
+  # @option opts [String] :days comma delimited day ids between 0-6
+  # @option opts [String] :service_body_ids comma delimited service body ids
+  # @option opts [String] :search_string string
+  # @return [Array<Meeting>]
+  describe 'get_meetings test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for get_service_bodies
+  # Retrieves service bodies
+  # Retrieve service bodies for authenticated user.
+  # @param [Hash] opts the optional parameters
+  # @return [Array<ServiceBody>]
+  describe 'get_service_bodies test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for get_service_body
+  # Retrieves a service body
+  # Retrieve a single service body by id.
+  # @param service_body_id ID of service body
+  # @param [Hash] opts the optional parameters
+  # @return [ServiceBody]
+  describe 'get_service_body test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for get_user
+  # Retrieves a single user
+  # Retrieve single user.
+  # @param user_id ID of user
+  # @param [Hash] opts the optional parameters
+  # @return [User]
+  describe 'get_user test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for get_users
+  # Retrieves users
+  # Retrieve users for authenticated user.
+  # @param [Hash] opts the optional parameters
+  # @return [Array<User>]
+  describe 'get_users test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for partial_update_user
+  # Patches a user
+  # Patches a user by id.
+  # @param user_id ID of user
+  # @param user_partial_update Pass in fields you want to update.
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'partial_update_user test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for patch_format
+  # Patches a format
+  # Patches a single format by id.
+  # @param format_id ID of format
+  # @param format_partial_update Pass in fields you want to update.
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'patch_format test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for patch_meeting
+  # Patches a meeting
+  # Patches a meeting by id
+  # @param meeting_id ID of meeting
+  # @param meeting_partial_update Pass in fields you want to update.
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'patch_meeting test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for patch_service_body
+  # Patches a service body
+  # Patches a single service body by id.
+  # @param service_body_id ID of service body
+  # @param service_body_partial_update Pass in fields you want to update.
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'patch_service_body test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for update_format
+  # Updates a format
+  # Updates a format.
+  # @param format_id ID of format
+  # @param format_update Pass in format object
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'update_format test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for update_meeting
+  # Updates a meeting
+  # Updates a meeting.
+  # @param meeting_id ID of meeting
+  # @param meeting_update Pass in meeting object
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'update_meeting test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for update_service_body
+  # Updates a Service Body
+  # Updates a single service body.
+  # @param service_body_id ID of service body
+  # @param service_body_update Pass in service body object
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'update_service_body test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+  # unit tests for update_user
+  # Update single user
+  # Updates a user.
+  # @param user_id ID of user
+  # @param user_update Pass in user object
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'update_user test' do
+    it 'should work' do
+      # assertion here. ref: https://www.relishapp.com/rspec/rspec-expectations/docs/built-in-matchers
+    end
+  end
+
+end