{"openapi":"3.0.0","servers":[{"description":"SwaggerHub API Auto Mocking","url":"https://virtserver.swaggerhub.com/Coder-for-Life/3DAdapt/1.0.0"},{"description":"Server","url":"https://3dadapt.xyz/api/v1"}],"info":{"title":"3DAdapt API","description":"3DAdapt API","version":"1.0.0","contact":{"email":"bushj@moravian.edu"},"license":{"name":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}},"tags":[{"name":"users","description":"User accounts and authentication"},{"name":"organization","description":"Organization of designs"},{"name":"designs","description":"Design information"},{"name":"makes","description":"Make information"},{"name":"likes","description":"Likes of designs, collections, and makes"},{"name":"collections","description":"Collections of designs"},{"name":"moderation","description":"Moderation of content on the site"}],"paths":{"/login":{"post":{"tags":["auth"],"summary":"Login","description":"Once a user is logged in, all authentication-required APIs are available (although 403 Forbidden responses are still possible for resources not available for this user)","operationId":"login_user","requestBody":{"description":"Authentication information, must provide username or email along with the password","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["username","password"],"properties":{"username":{"type":"string","example":"coder-for-life"},"password":{"type":"string","format":"password","example":"secret"}}},{"type":"object","required":["email","password"],"properties":{"email":{"type":"string","format":"email","example":"bushj@moravian.edu"},"password":{"type":"string","format":"password","example":"secret"}}}]}}}},"responses":{"200":{"$ref":"#/components/responses/LoginTokens"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"description":"Unauthorized (401) - bad login information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/refresh":{"post":{"tags":["auth"],"summary":"Refresh the user's logged in state","description":"Whenever the JWT access token expires the refresh token can be used to generate a new access token. Only the refresh token should be submitted at this point.","security":[{"jwt":[]}],"responses":{"200":{"description":"The refreshed access token for maintaining logged in state","content":{"application/json":{"schema":{"type":"object","properties":{"access_token":{"type":"string","description":"the JWT access token for maintaining logged-in state"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/logout":{"delete":{"tags":["auth"],"summary":"Logout a user, invalidating a token","description":"Only the refresh token must be submitted at this point. The access token will expire automatically after a short time but can be submitted if desired.","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/user":{"get":{"tags":["users"],"summary":"Get the current logged in user","operationId":"get_current_user","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/User"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["users"],"summary":"Create a user. This also auto-logins the user so JWT tokens are provided as well. NOTE: This can take up to 16 seconds to complete!","operationId":"create_user","requestBody":{"description":"user to create","content":{"application/json":{"schema":{"type":"object","required":["username","password","email"],"properties":{"username":{"type":"string","example":"coder-for-life"},"email":{"type":"string","format":"email","example":"bushj@moravian.edu"},"password":{"type":"string","format":"password","example":"secret","description":"minimum 8 characters and a \"50%\" complexity, no maximum length"},"agree_to_terms":{"type":"boolean","example":true,"description":"must be true to create an account"}}}}}},"responses":{"201":{"description":"Created user information and access token","content":{"application/json":{"schema":{"type":"object","required":["user","login"],"properties":{"user":{"$ref":"#/components/schemas/User"},"login":{"$ref":"#/components/schemas/LoginTokens"}}}}}},"400":{"description":"Bad Request (400) - bad request or invalid username/password/email","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflicting Resource (409) - a user with that username/email already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["users"],"summary":"Update the current logged in user. All fields are optional.","operationId":"update_current_user","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"subscriptions":{"$ref":"#/components/schemas/SubscriptionOptions"},"watch_update_freq":{"$ref":"#/components/schemas/UpdateFrequency"}}}}}},"responses":{"200":{"$ref":"#/components/responses/User"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/user/set-email":{"patch":{"tags":["users"],"summary":"Update the current logged in user's email. NOTE: This can take up to 16 seconds to complete!","operationId":"set_email","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email","example":"bushj@moravian.edu"}}}}}},"responses":{"200":{"$ref":"#/components/responses/User"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/user/set-password":{"put":{"tags":["users"],"summary":"Update the current user's password","operationId":"set_password","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["current_password","new_password"],"properties":{"current_password":{"type":"string","format":"password","example":"old-secret"},"new_password":{"type":"string","format":"password","example":"new-secret"}}}}}},"responses":{"200":{"$ref":"#/components/responses/LoginTokens"},"400":{"description":"Bad Request (400) - bad request, bad current password, or weak new password","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/user/password-reset":{"post":{"tags":["users"],"summary":"Initiate the reset of a user's password with their email (not username)","description":"Cause an email to be sent to the user with a code (6 random letters and numbers) to confirm. After submitting this, the user should be shown a screen to type in the code along with a new password. It should inform them that they have 15 minutes before the code expires. If the email is not found, this return success as to prevent hunting for registered emails.","operationId":"init_reset_password","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email","example":"bushj@moravian.edu"}}}}}},"responses":{"200":{"$ref":"#/components/responses/Success"},"400":{"$ref":"#/components/responses/BadRequest"}}},"put":{"tags":["users"],"summary":"Complete the reset of a user's password","description":"Must provide the same email that was provided to generate the code.","operationId":"reset_password","requestBody":{"content":{"application/json":{"schema":{"required":["email","token","password"],"properties":{"email":{"description":"their email","type":"string","example":"bushj@moravian.edu"},"token":{"description":"the code sent to the user's email (6 characters long)","type":"string"},"password":{"example":"the new password","type":"string"}}}}}},"responses":{"200":{"$ref":"#/components/responses/Success"},"400":{"description":"Bad Request (400) - bad request or invalid password","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not Found (404) - email and code do not match or code is expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/user/verify-email/send":{"put":{"tags":["users"],"summary":"Send the current user a verification email if they haven't already verified their email. This is automatically triggered when the user's account is created or their email is updated, this API is only needed if they lose the email.","operationId":"send_verification_email","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/user/verify-email/{code}":{"parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"example":"fe3d15b1-4283-448f-8ffc-39accd86f9ca"}],"get":{"tags":["users"],"summary":"Verify an email address with a special code. This is accomplished through the email sent to the user and not exposed to the user directly.","operationId":"verify_email","responses":{"200":{"$ref":"#/components/responses/Success"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/user/unsubscribe/{option}":{"parameters":[{"name":"option","in":"path","required":true,"schema":{"$ref":"#/components/schemas/SubscriptionOption"}}],"delete":{"tags":["users"],"summary":"Unsubscribe from a specific option","operationId":"unsubscribe","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/user/unsubscribe-from-all":{"delete":{"tags":["users"],"summary":"Unsubscribe from all options, does not include watches","operationId":"unsubscribe_from_all","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/users":{"get":{"tags":["users"],"parameters":[{"name":"with-permission","in":"query","description":"filter to users with the given permission, if not provided no filtering is done","allowEmptyValue":true,"schema":{"$ref":"#/components/schemas/Permission"}},{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"}],"summary":"List all users","description":"Not available in the app, only available to a limited set of users","operationId":"list_users","deprecated":true,"security":[{"jwt":[]}],"responses":{"200":{"description":"page of users","content":{"application/json":{"schema":{"type":"object","required":["page","values"],"properties":{"page":{"$ref":"#/components/schemas/PageWithTotal"},"values":{"type":"array","items":{"$ref":"#/components/schemas/User"}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/users/{username}":{"parameters":[{"$ref":"#/components/parameters/Username"}],"get":{"tags":["users"],"summary":"Get a user's info","description":"Not available in the app, only available to a limited set of users; generally you want to use /profile/{username}","operationId":"get_user","deprecated":true,"security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/User"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/users/{username}/permissions":{"parameters":[{"$ref":"#/components/parameters/Username"}],"get":{"tags":["users"],"summary":"Get a user's permissions","description":"Not available in the app, only available to a limited set of users","operationId":"get_user_permissions","deprecated":true,"security":[{"jwt":[]}],"responses":{"200":{"description":"The permissions for the given user","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Permissions"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"post":{"tags":["users"],"summary":"Set a user's permissions","description":"Not available in the app, only available to a limited set of users","operationId":"set_user_permissions","deprecated":true,"security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Permissions"}}}},"responses":{"200":{"$ref":"#/components/responses/User"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"patch":{"tags":["users"],"summary":"Add a permission to a user","description":"Not available in the app, only available to a limited set of users","operationId":"add_user_permissions","deprecated":true,"security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Permissions"}}}},"responses":{"200":{"$ref":"#/components/responses/User"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["users"],"summary":"Remove all permissions from a user","description":"Not available in the app, only available to a limited set of users","operationId":"remove_user_permissions","deprecated":true,"security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/User"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/users/{username}/lock":{"parameters":[{"$ref":"#/components/parameters/Username"}],"post":{"tags":["users"],"summary":"Lock a user, preventing that account from being logged into","description":"Not available in the app, only available to a limited set of users","operationId":"lock_user","deprecated":true,"security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"201":{"$ref":"#/components/responses/Success"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/users/{username}/unlock":{"parameters":[{"$ref":"#/components/parameters/Username"}],"post":{"tags":["users"],"summary":"Unlock a user, allowing that account to be logged into","description":"Any permissions set on the user before being locked will be erased. Not available in the app, only available to a limited set of users","operationId":"unlock_user","deprecated":true,"security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"201":{"$ref":"#/components/responses/Success"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profile":{"get":{"tags":["users"],"summary":"Get the current user's profile.","operationId":"get_current_profile","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Profile"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"patch":{"tags":["users"],"summary":"Update the current user's profile","description":"All keys are optional and only provided keys are updated","operationId":"update_current_profile","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tagline":{"type":"string","example":"Professor of Computer Science, Moravian University","description":"Max length is 255 characters","maxLength":255},"bio":{"type":"string","example":"Can be a very long string describing the person, <b>their goals with this tool</b>, and whatever...","format":"html","description":"HTML formatted, max length of 16384 characters","maxLength":16384},"roles":{"$ref":"#/components/schemas/Roles"}}}}}},"responses":{"200":{"$ref":"#/components/responses/Profile"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/profile/avatar":{"put":{"tags":["users"],"summary":"Set the current user's avatar image","description":"Upload an image to use as the user's avatar image. The image should already be scaled and cropped to 300x300. If it isn't the server will adjust it, but this will waste a lot of bandwidth and server time.\n\nThe binary data of the image is sent directly (not wrapped in JSON or base64 encoded). The server supports at least PNG, JPEG, GIF, BMP, and WEBP file.\n","operationId":"set_current_profile_avatar","security":[{"jwt":[]}],"requestBody":{"$ref":"#/components/requestBodies/RawImage"},"responses":{"200":{"$ref":"#/components/responses/Profile"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["users"],"summary":"Reset the current user's avatar image to the default","operationId":"reset_current_profile_avatar","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Profile"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/profile/cover":{"put":{"tags":["users"],"summary":"Set the current user's cover image","description":"Upload an image to use as the user's cover image. The image should already be scaled and cropped to ???x???. If it isn't the server will adjust it, but this will waste a lot of bandwidth and server time.\n\nThe binary data of the image is sent directly (not wrapped in JSON or base64 encoded). The server supports at least PNG, JPEG, GIF, BMP, and WEBP file.\n","operationId":"set_current_profile_cover","security":[{"jwt":[]}],"requestBody":{"$ref":"#/components/requestBodies/RawImage"},"responses":{"200":{"$ref":"#/components/responses/Profile"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["users"],"summary":"Reset the current user's cover image to the default","operationId":"reset_current_profile_cover","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Profile"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/profile/favorites":{"get":{"tags":["users"],"summary":"Get the favorites of the current user as actual items instead of references","operationId":"get_favorites","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/FavoriteList"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"put":{"tags":["users"],"summary":"Set the list of favorites","operationId":"set_favorites","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ItemRef"},"maxLength":6}}}},"responses":{"200":{"$ref":"#/components/responses/Profile"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"post":{"tags":["users"],"summary":"Add an item as a favorite","operationId":"add_favorite","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemRef"}}}},"responses":{"200":{"$ref":"#/components/responses/Profile"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"patch":{"tags":["users"],"summary":"Remove an item as a favorite","operationId":"remove_favorite","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemRef"}}}},"responses":{"200":{"$ref":"#/components/responses/Profile"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/profile/followers":{"get":{"tags":["users"],"summary":"Get the followers of the current user (paged)","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Roles"},{"$ref":"#/components/parameters/AllRoles"}],"operationId":"get_followers","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/PageOfProfiles"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/profile/following":{"get":{"tags":["users"],"summary":"Get the users the current user is following (paged)","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Roles"},{"$ref":"#/components/parameters/AllRoles"}],"operationId":"get_following","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/PageOfProfiles"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/profile/following/{username}":{"parameters":[{"$ref":"#/components/parameters/Username"}],"get":{"tags":["users"],"summary":"Get if the current user is following the given user (same as /profiles/{username}/follow)","operationId":"is_following_user","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Boolean"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/profile/unfollow-all":{"post":{"tags":["users"],"summary":"Unfollow all users","operationId":"unfollow_all","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"201":{"$ref":"#/components/responses/Success"}}}},"/profiles":{"get":{"tags":["users"],"summary":"Get a list of user profiles (paged)","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Roles"},{"$ref":"#/components/parameters/AllRoles"}],"operationId":"get_profiles","responses":{"200":{"$ref":"#/components/responses/PageOfProfiles"}}}},"/profiles/{username}":{"parameters":[{"$ref":"#/components/parameters/Username"}],"get":{"tags":["users"],"summary":"Get a user's profile","operationId":"get_user_profile","responses":{"200":{"$ref":"#/components/responses/Profile"},"404":{"$ref":"#/components/responses/NotFound"}}},"patch":{"tags":["users"],"summary":"Update the a user's profile","description":"Not available in the app, only available to a limited set of users","operationId":"update_profile","deprecated":true,"security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tagline":{"type":"string","example":"Professor of Computer Science, Moravian University"},"bio":{"type":"string","example":"Can be a very long string describing the person, <b>their goals with this app</b>, and whatever...","format":"html","maxLength":16384,"description":"HTML formatted, max length of 16384 characters"},"roles":{"$ref":"#/components/schemas/Roles"}}}}}},"responses":{"200":{"$ref":"#/components/responses/Profile"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profiles/{username}/avatar":{"parameters":[{"$ref":"#/components/parameters/Username"}],"delete":{"tags":["users"],"summary":"Reset a user's avatar image to the default","description":"Not available in the app, only available to a limited set of users","operationId":"reset_profile_avatar","deprecated":true,"security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Profile"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profiles/{username}/cover":{"parameters":[{"$ref":"#/components/parameters/Username"}],"delete":{"tags":["users"],"summary":"Reset a user's cover image to the default","description":"Not available in the app, only available to a limited set of users","operationId":"reset_profile_cover","deprecated":true,"security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Profile"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profiles/{username}/favorites":{"parameters":[{"$ref":"#/components/parameters/Username"}],"get":{"tags":["users"],"summary":"Get the favorites of a user as actual items instead of references","operationId":"get_user_favorites","responses":{"200":{"$ref":"#/components/responses/FavoriteList"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profiles/{username}/followers":{"parameters":[{"$ref":"#/components/parameters/Username"}],"get":{"tags":["users"],"summary":"Get the followers of the given user (paged)","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Roles"},{"$ref":"#/components/parameters/AllRoles"}],"operationId":"get_followers_of","responses":{"200":{"$ref":"#/components/responses/PageOfProfiles"}}}},"/profiles/{username}/following":{"parameters":[{"$ref":"#/components/parameters/Username"}],"get":{"tags":["users"],"summary":"Get the users following the given user (paged)","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Roles"},{"$ref":"#/components/parameters/AllRoles"}],"operationId":"get_following_by","responses":{"200":{"$ref":"#/components/responses/PageOfProfiles"}}}},"/profiles/{username}/follow":{"parameters":[{"$ref":"#/components/parameters/Username"}],"get":{"tags":["users"],"summary":"Get if the current user is following the given user (same as /profile/following/{username})","operationId":"is_following_user*","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Boolean"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["users"],"summary":"Have the current user follow another user","operationId":"follow_user","security":[{"jwt":[]}],"responses":{"200":{"description":"was already following the user","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"201":{"description":"started following the user","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["users"],"summary":"Have the current user unfollow another user","operationId":"unfollow_user","security":[{"jwt":[]}],"responses":{"200":{"description":"was already not following the user","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"201":{"description":"stopped following the user","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/profiles/{follower}/follows/{followed}":{"parameters":[{"in":"path","name":"follower","required":true,"schema":{"type":"string"},"example":"coder-for-life"},{"in":"path","name":"followed","required":true,"schema":{"type":"string"},"example":"coder-for-life"}],"get":{"tags":["users"],"summary":"Check if a user follows another user","operationId":"follows","responses":{"200":{"$ref":"#/components/responses/Boolean"}}}},"/reports":{"get":{"tags":["moderation"],"summary":"Get reports submitted by the current user","operationId":"list_my_reports","security":[{"jwt":[]}],"parameters":[{"name":"unresolved","in":"query","description":"Only return unresolved reports","allowEmptyValue":true,"schema":{"type":"boolean","default":false}},{"name":"search","in":"query","description":"Only return reports that match this search query","allowEmptyValue":true,"schema":{"type":"string","default":null}},{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"page of reports","content":{"application/json":{"schema":{"type":"object","properties":{"page":{"$ref":"#/components/schemas/PageWithTotal"},"reports":{"type":"array","items":{"$ref":"#/components/schemas/ReportBrief"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["moderation"],"summary":"Submit a report/flag about inappropriate content on the site","operationId":"submit_report","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["type","item","details"],"properties":{"type":{"$ref":"#/components/schemas/ReportItemType"},"item":{"description":"The identifier of the thing being reported, for a profile this is the username for others this is their ID","type":"string","example":"coder-for-life"},"comment_id":{"description":"The id of the comment if the reported item is a comment, not populated otherwise","type":"integer"},"details":{"description":"The detailed information about what is inappropriate about the content","type":"string","minLength":16,"maxLength":8192}}}}}},"responses":{"201":{"$ref":"#/components/responses/Report"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/reports/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"tags":["moderation"],"summary":"Get a report from its id","operationId":"get_report","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Report"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"post":{"tags":["moderation"],"summary":"Comment on a report and possibly mark it as resolved","operationId":"comment_on_report","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"description":"The comment text","type":"string","minLength":16,"maxLength":8192},"resolve":{"description":"If this comment marks the report as resolved. If this is included, this always sets the resolved state (so can set it to false i.e. un-resolve it). To keep the current state, don't provide this key or set it to null.","type":"boolean","default":false}}}}}},"responses":{"201":{"$ref":"#/components/responses/Report"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/reports/moderation":{"get":{"tags":["moderation"],"summary":"Get reports submitted for moderation","operationId":"list_reports","deprecated":true,"security":[{"jwt":[]}],"parameters":[{"name":"unresolved","in":"query","description":"Only return unresolved reports","allowEmptyValue":true,"schema":{"type":"boolean","default":false}},{"name":"search","in":"query","description":"Only return reports that match this search query","allowEmptyValue":true,"schema":{"type":"string","default":null}},{"name":"type","in":"query","description":"Only return reports that match this type","allowEmptyValue":true,"schema":{"$ref":"#/components/schemas/ReportItemType"}},{"name":"updatedBefore","in":"query","description":"Only return reports that were last updated before the given date (no time)","allowEmptyValue":true,"schema":{"type":"string","format":"datetime"}},{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"page of reports","content":{"application/json":{"schema":{"type":"object","properties":{"page":{"$ref":"#/components/schemas/PageWithTotal"},"reports":{"type":"array","items":{"$ref":"#/components/schemas/ReportBrief"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/licenses":{"get":{"tags":["other"],"summary":"Get the list of all usable licenses","description":"These should be cached and only refreshed once in a long while (like weekly or monthly maybe). All of the images should be cached as well.","operationId":"get_licenses","responses":{"200":{"description":"list of all licenses","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/License"}}}}}}},"post":{"tags":["other"],"summary":"Add a new license","description":"This should not be made available through the app, this will only be available to a select few individuals.","operationId":"add_license","deprecated":true,"security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/License"}}}},"responses":{"201":{"$ref":"#/components/responses/License"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/licenses/{name}":{"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"},"example":"CC BY-NC-ND"}],"get":{"tags":["other"],"summary":"Get a single license by name","operationId":"get_license","responses":{"200":{"$ref":"#/components/responses/License"},"404":{"$ref":"#/components/responses/NotFound"}}},"patch":{"tags":["other"],"summary":"Update a license","description":"This should not be made available through the app, this will only be available to a select few individuals.","operationId":"update_license","deprecated":true,"security":[{"jwt":[]}],"requestBody":{"description":"name cannot be changed, all other fields are optional in this context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/License"}}}},"responses":{"200":{"$ref":"#/components/responses/License"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/tags":{"get":{"tags":["organization"],"summary":"Get the list of all tags. Should be cached. In all other APIs, only the id of the tag is used.","operationId":"get_tags","responses":{"200":{"description":"The list of tags","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Tag"}}}}}}},"post":{"tags":["organization"],"summary":"Add a new tag; Not available in app","operationId":"add_tag","deprecated":true,"security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tag"}}}},"responses":{"201":{"$ref":"#/components/responses/Tag"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/tags/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"patch":{"tags":["organization"],"summary":"Update a tag. Not available in the app.","description":"All fields are optional, if not provided will not be changed.","operationId":"update_tag","deprecated":true,"security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","example":"d329"},"category":{"type":"string","example":"env"},"short":{"type":"string","example":"Receiving"},"name":{"type":"string","example":"Communication - Receiving"},"desc":{"type":"string"}}}}}},"responses":{"200":{"$ref":"#/components/responses/Tag"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}},"delete":{"tags":["organization"],"summary":"Remove a tag. Only possible with empty tags. Not available in the app.","operationId":"delete_tag","deprecated":true,"security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/categories":{"get":{"tags":["organization"],"summary":"Get the list of all categories. Should be cached. In all other APIs, only the id of the category is used.","operationId":"get_categories","responses":{"200":{"description":"The list of categories","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Category"}}}}}}},"post":{"tags":["organization"],"summary":"Add a new category; Not available in app","operationId":"add_category","deprecated":true,"security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Category"}}}},"responses":{"201":{"$ref":"#/components/responses/Category"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/categories/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"patch":{"tags":["organization"],"summary":"Update a category. Not available in the app.","description":"All fields are optional, if not provided will not be changed.","operationId":"update_category","deprecated":true,"security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","example":"activity"},"order":{"type":"integer","example":3}}}}}},"responses":{"200":{"$ref":"#/components/responses/Category"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}},"delete":{"tags":["organization"],"summary":"Remove a category. Only possible with empty categories. Not available in the app.","operationId":"delete_category","deprecated":true,"security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/design":{"post":{"tags":["designs"],"summary":"Add a new design","description":"This creates the basics of a new design but after this the images and files must be uploaded as well","operationId":"add_design","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name","purpose","tags","license","desc"],"properties":{"name":{"description":"name for this design","type":"string","example":"Assistive Bottle Opener","minLength":8,"maxLength":255},"purpose":{"description":"short string describing the purpose of this design","type":"string","example":"Helps you open a bottle","minLength":32,"maxLength":255},"tags":{"description":"the list of tags assigned to this design","type":"array","items":{"type":"string"},"minLength":3,"maxLength":16},"remix_of":{"description":"optional; the design id of what this design was remixed from","type":"string"},"customizable":{"description":"if the design can be customized","type":"boolean","default":false},"license":{"description":"a license id","type":"string","example":"CC-BY-NC-ND"},"desc":{"description":"description of the design","type":"string","format":"html","maxLength":32768},"external":{"$ref":"#/components/schemas/External"}}}}}},"responses":{"200":{"$ref":"#/components/responses/Design"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/design/grab":{"get":{"tags":["designs"],"summary":"Grab a design from an external source","operationId":"grab_external_design","parameters":[{"in":"query","name":"url","description":"the URL to grab data from","schema":{"type":"string"}}],"responses":{"200":{"description":"grabbed information, roughly lining up with a design value","content":{"application/json":{"schema":{"type":"object","required":["name","external","license","images","files","desc"],"properties":{"name":{"type":"string","example":"Assistive Bottle Opener","maxLength":255},"external":{"$ref":"#/components/schemas/External"},"cover":{"description":"external URL to the cover photo for this item","type":"string","format":"url","example":"https://3dadapt.xyz/images/abcdef.webp"},"license":{"description":"a license id","type":"string","example":"CC-BY-NC-ND"},"desc":{"description":"description of the item, not included except when a single item is directly requested","type":"string","format":"html","maxLength":32768},"remix_of":{"description":"the external URL remixed from, or null","type":"string","format":"url","default":null},"images":{"description":"List of image names/descriptions and external URLs","type":"array","items":{"type":"array","minLength":2,"maxLength":2,"items":{"type":"string"}}},"files":{"description":"Object associating file name/description with external URL","type":"object","additionalProperties":{"description":"the URL for each file","type":"string","format":"url"}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/design/import":{"post":{"tags":["designs"],"summary":"Import a design from an external source","operationId":"import_design","security":[{"jwt":[]}],"requestBody":{"description":"the design to import and additional needed information","content":{"application/json":{"schema":{"type":"object","required":["url","purpose","tags"],"properties":{"url":{"type":"string","example":"external URL of the design to import"},"purpose":{"description":"short string describing the purpose of this design","type":"string","example":"Helps you open a bottle","maxLength":255},"tags":{"description":"the list of tags assigned to this design","type":"array","items":{"type":"string"},"default":[]}}}}}},"responses":{"200":{"$ref":"#/components/responses/Design"},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/design/import-many":{"post":{"tags":["designs"],"summary":"Import many designs from an external source, must be a moderator to use this. Automatically skips already-imported designs.","operationId":"import_designs","security":[{"jwt":[]}],"requestBody":{"description":"the designs to import and their additional needed information","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["url","purpose","tags"],"properties":{"url":{"type":"string","example":"external URL of the design to import"},"purpose":{"description":"short string describing the purpose of this design","type":"string","example":"Helps you open a bottle","maxLength":255},"tags":{"description":"the list of tags assigned to this design","type":"array","items":{"type":"string"},"default":[]}}}}}}},"responses":{"200":{"description":"streaming status messages, since this command can take quite a long time, this streams the results of each individual import","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/designs":{"get":{"tags":["designs"],"summary":"Get the list of designs","operationId":"get_designs","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Tags"},{"$ref":"#/components/parameters/Customizable"},{"$ref":"#/components/parameters/HasSingle"},{"$ref":"#/components/parameters/HasMakes"},{"$ref":"#/components/parameters/IsRemix"},{"$ref":"#/components/parameters/Made"},{"$ref":"#/components/parameters/Collected"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"description":"page of designs","content":{"application/json":{"schema":{"type":"object","required":["page","values","tags"],"properties":{"page":{"$ref":"#/components/schemas/Page"},"values":{"type":"array","items":{"$ref":"#/components/schemas/Design"}},"tags":{"description":"Object of all of tags (keys) and their counts (values) for the entire given search (not just the single page), not including 0 count tags","type":"object","additionalProperties":{"description":"the count of each tag","type":"integer"},"example":{"d329":2,"d349":1,"e110":1}}}}}}}}}},"/designs/{design}":{"parameters":[{"$ref":"#/components/parameters/DesignId"}],"get":{"tags":["designs"],"summary":"Get a full design by id; the images and files fields are returned fully in this case instead of counts","operationId":"get_design","responses":{"200":{"$ref":"#/components/responses/Design"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"patch":{"tags":["designs"],"summary":"Update an design","description":"Only the given keys will be updated","operationId":"update_design","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"description":"name for this design","type":"string","example":"Assistive Bottle Opener","minLength":8,"maxLength":255},"purpose":{"description":"short string describing the purpose of this design","type":"string","example":"Helps you open a bottle","minLength":32,"maxLength":255},"tags":{"description":"the list of tags assigned to this design","type":"array","items":{"type":"string"},"minLength":3,"maxLength":16},"remix_of":{"description":"optional; the design id of what this design was remixed from","type":"string"},"customizable":{"description":"if the design can be customized","type":"boolean","default":false},"license":{"description":"a license id","type":"string","example":"CC-BY-NC-ND"},"desc":{"description":"description of the design","type":"string","format":"html","maxLength":32768},"cover":{"description":"image link to set as the cover image for this design","type":"string"},"external":{"$ref":"#/components/schemas/External"}}}}}},"responses":{"200":{"$ref":"#/components/responses/Design"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["designs"],"summary":"Delete an unpublished design","description":"You can only delete designs that have not been published","operationId":"remove_design","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/file":{"parameters":[{"$ref":"#/components/parameters/DesignId"}],"post":{"tags":["designs"],"summary":"Add a files to a design","operationId":"add_design_file","security":[{"jwt":[]}],"requestBody":{"$ref":"#/components/requestBodies/AddFile"},"responses":{"201":{"$ref":"#/components/responses/File"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/files/{id}":{"parameters":[{"$ref":"#/components/parameters/DesignId"},{"$ref":"#/components/parameters/FileId"}],"patch":{"tags":["designs"],"summary":"Update a file in a design","operationId":"update_design_file","security":[{"jwt":[]}],"requestBody":{"$ref":"#/components/requestBodies/UpdateFile"},"responses":{"201":{"$ref":"#/components/responses/File"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["designs"],"summary":"Delete an image from a design","operationId":"remove_design_file","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/files/{id}/customize":{"parameters":[{"$ref":"#/components/parameters/DesignId"},{"$ref":"#/components/parameters/FileId"}],"post":{"tags":["designs"],"summary":"Customize a file in a design, needs to be polled until complete","operationId":"customize_file","security":[{"jwt":[]}],"requestBody":{"description":"customization parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomizationValues"}}}},"responses":{"200":{"$ref":"#/components/responses/CustomizedFile"},"201":{"$ref":"#/components/responses/CustomizedFile"},"400":{"$ref":"#/components/responses/BadRequest"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/printset":{"parameters":[{"$ref":"#/components/parameters/DesignId"}],"post":{"tags":["designs"],"summary":"Add a printset to a design","operationId":"add_design_printset","security":[{"jwt":[]}],"requestBody":{"description":"printset information, all fields are optional","content":{"application/json":{"schema":{"type":"object","required":["name","files"],"properties":{"name":{"description":"name of the printset","type":"string","maxLength":255},"desc":{"description":"optional description of the printset","type":"string","maxLength":255,"default":""},"files":{"description":"list of file information for this printset","minLength":1,"maxLength":25,"type":"array","items":{"oneOf":[{"type":"string","description":"file id"},{"$ref":"#/components/schemas/PrintsetFile"}]}}}}}}},"responses":{"201":{"$ref":"#/components/responses/Printset"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/printsets/{id}":{"parameters":[{"$ref":"#/components/parameters/DesignId"},{"$ref":"#/components/parameters/PrintsetId"}],"patch":{"tags":["designs"],"summary":"Update a printset in a design","operationId":"update_design_printset","security":[{"jwt":[]}],"requestBody":{"description":"printset information to be updated, all fields are optional","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"description":"name of the printset","type":"string","maxLength":255,"default":null},"desc":{"description":"optional description of the printset","type":"string","maxLength":255,"default":null},"files":{"description":"list of file information for this printset; completely replaces any existing list of files","minLength":1,"maxLength":25,"default":null,"type":"array","items":{"oneOf":[{"type":"string","description":"file id"},{"$ref":"#/components/schemas/PrintsetFile"}]}}}}}}},"responses":{"201":{"$ref":"#/components/responses/Printset"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["designs"],"summary":"Delete an image from a design","operationId":"remove_design_printset","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/printset/{id}/customize":{"parameters":[{"$ref":"#/components/parameters/DesignId"},{"$ref":"#/components/parameters/PrintsetId"}],"post":{"tags":["designs"],"summary":"Customize a printset in a design","operationId":"customize_printset","security":[{"jwt":[]}],"requestBody":{"description":"customization parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomizationValues"}}}},"responses":{"200":{"$ref":"#/components/responses/CustomizedPrintset"},"201":{"$ref":"#/components/responses/CustomizedPrintset"},"400":{"$ref":"#/components/responses/BadRequest"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/remixes":{"parameters":[{"$ref":"#/components/parameters/DesignId"}],"get":{"tags":["designs"],"summary":"Get the list of remixes of a design, needs to be polled until complete","operationId":"get_design_remixes","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Tags"},{"$ref":"#/components/parameters/Customizable"},{"$ref":"#/components/parameters/HasSingle"},{"$ref":"#/components/parameters/HasMakes"},{"$ref":"#/components/parameters/IsRemix"},{"$ref":"#/components/parameters/Made"},{"$ref":"#/components/parameters/Collected"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfDesigns"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profile/designs":{"get":{"tags":["designs"],"summary":"Get the list of designs by the current user, does not include imports","operationId":"get_designs_self","security":[{"jwt":[]}],"parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Tags"},{"$ref":"#/components/parameters/Customizable"},{"$ref":"#/components/parameters/HasSingle"},{"$ref":"#/components/parameters/HasMakes"},{"$ref":"#/components/parameters/IsRemix"},{"$ref":"#/components/parameters/Made"},{"$ref":"#/components/parameters/Collected"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfDesigns"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/profiles/{username}/designs":{"parameters":[{"$ref":"#/components/parameters/Username"}],"get":{"tags":["designs"],"summary":"Get the list of designs by a specific user, does not include imports","operationId":"get_designs_by","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Tags"},{"$ref":"#/components/parameters/Customizable"},{"$ref":"#/components/parameters/HasSingle"},{"$ref":"#/components/parameters/HasMakes"},{"$ref":"#/components/parameters/IsRemix"},{"$ref":"#/components/parameters/Made"},{"$ref":"#/components/parameters/Collected"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfDesigns"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profile/imports":{"get":{"tags":["designs"],"summary":"Get the list of imported designs by the current user","operationId":"get_imports_self","security":[{"jwt":[]}],"parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Tags"},{"$ref":"#/components/parameters/Customizable"},{"$ref":"#/components/parameters/HasSingle"},{"$ref":"#/components/parameters/HasMakes"},{"$ref":"#/components/parameters/IsRemix"},{"$ref":"#/components/parameters/Made"},{"$ref":"#/components/parameters/Collected"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfDesigns"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/profiles/{username}/imports":{"parameters":[{"$ref":"#/components/parameters/Username"}],"get":{"tags":["designs"],"summary":"Get the list of imported designs by a specific user","operationId":"get_imports_by","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Tags"},{"$ref":"#/components/parameters/Customizable"},{"$ref":"#/components/parameters/HasSingle"},{"$ref":"#/components/parameters/HasMakes"},{"$ref":"#/components/parameters/IsRemix"},{"$ref":"#/components/parameters/Made"},{"$ref":"#/components/parameters/Collected"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfDesigns"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/ordering-services":{"get":{"tags":["orders"],"summary":"Get the list of ordering services","operationId":"get_ordering_services","responses":{"200":{"description":"List of all known ordering services","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"object","required":["id","order","logo","banner","name","url","description"],"properties":{"order":{"description":"the order the services should be displayed in","type":"integer"},"id":{"description":"the id of the service","type":"string"},"name":{"description":"the display name of the service","type":"string"},"url":{"description":"the homepage url of the service","type":"string","format":"uri"},"logo":{"description":"URL of the logo image, 600x400px","type":"string","format":"uri"},"banner":{"description":"URL of the banner image, 2000x250px","type":"string","format":"uri"},"description":{"description":"the description of the service","type":"string"}}}}}}}}}},"/order":{"post":{"tags":["orders"],"summary":"Create a new order","description":"This creates a new order and returns the redirect URL to complete the order; this may require being called multiple times until it is ready","operationId":"order","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["type","design","id","service"],"properties":{"type":{"description":"type of item being ordered","type":"string","enum":["file","printset"]},"design":{"description":"design containing the item being ordered","type":"string","maxLength":64},"id":{"description":"id of the item being ordered","type":"string","maxLength":64},"params":{"$ref":"#/components/schemas/CustomizationValues"},"service":{"description":"ordering service to use","type":"string"},"options":{"description":"options for the ordering service","type":"object"}}}}}},"responses":{"200":{"description":"Order started (or pending)","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"description":"redirection url to complete the order, if null, the request must be submitted again in a short amount of time (it is waiting for customization or similar to complete)","type":"string","format":"uri","default":null}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"description":"Internal Server Error (500)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service Unavailable (503)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/designs/{design}/make":{"parameters":[{"$ref":"#/components/parameters/DesignId"}],"post":{"tags":["makes"],"summary":"Add a new make","description":"This creates the basics of a new make but after this the images must be uploaded as well","operationId":"add_make","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["desc"],"properties":{"desc":{"description":"description of the make","type":"string","format":"html","maxLength":8192},"ratings":{"$ref":"#/components/schemas/MakeRatings"}}}}}},"responses":{"200":{"$ref":"#/components/responses/Make"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/makes":{"get":{"tags":["makes"],"summary":"Get the list of makes","operationId":"get_makes","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfMakes"},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/makes/{make}":{"parameters":[{"$ref":"#/components/parameters/MakeId"}],"get":{"tags":["makes"],"summary":"Get a full make by id; the images field is returned fully in this case instead of just the count","operationId":"get_make","responses":{"200":{"$ref":"#/components/responses/Make"},"404":{"$ref":"#/components/responses/NotFound"}}},"patch":{"tags":["makes"],"summary":"Update a make","description":"Only the given keys will be updated","operationId":"update_make","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"desc":{"description":"description of the make","type":"string","format":"html","maxLength":8192},"ratings":{"$ref":"#/components/schemas/MakeRatings"},"cover":{"description":"image link to set as the cover image for this make","type":"string"}}}}}},"responses":{"200":{"$ref":"#/components/schemas/Make"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["makes"],"summary":"Delete a make","operationId":"remove_make","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/makes":{"parameters":[{"$ref":"#/components/parameters/DesignId"}],"get":{"tags":["makes"],"summary":"Get the list of makes of a particular design","operationId":"get_makes_of","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfMakes"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profile/makes":{"get":{"tags":["makes"],"summary":"Get the list of makes by the current user","operationId":"get_makes_self","security":[{"jwt":[]}],"parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfMakes"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/profiles/{username}/makes":{"parameters":[{"$ref":"#/components/parameters/Username"}],"get":{"tags":["makes"],"summary":"Get the list of makes by a specific user","operationId":"get_makes_by","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfMakes"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/collection":{"post":{"tags":["collections"],"summary":"Create a collection","operationId":"create_collection","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","example":"Things to Make","maxLength":255},"desc":{"type":"string","maxLength":8192}}}}}},"responses":{"201":{"$ref":"#/components/responses/Collection"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/collections":{"get":{"tags":["collections"],"summary":"Get the collections of a user","operationId":"get_collections","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfCollections"}}}},"/collections/{collection}":{"parameters":[{"$ref":"#/components/parameters/CollectionId"}],"get":{"tags":["collections"],"summary":"Get a collection","operationId":"get_collection","responses":{"200":{"$ref":"#/components/responses/Collection"},"404":{"$ref":"#/components/responses/NotFound"}}},"patch":{"tags":["collections"],"summary":"Update a collection","description":"All keys are optional and only provided keys are updated","operationId":"update_collection","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","example":"Things to Make","maxLength":255},"desc":{"type":"string","maxLength":8192},"cover_item":{"description":"The id of the design to use for the \"cover\" image; must be in the collection","type":"string","example":"my-first-design"},"owners":{"description":"The new set of owners for the collection","$ref":"#/components/schemas/Owners"}}}}}},"responses":{"200":{"$ref":"#/components/responses/Collection"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["collections"],"summary":"Remove a collection","operationId":"remove_collection","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/collections/{collection}/owners":{"parameters":[{"$ref":"#/components/parameters/CollectionId"}],"get":{"tags":["collections"],"summary":"Get the owners of a collection","operationId":"get_collection_owners","responses":{"200":{"description":"profiles of owners","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Profile"}}}}},"404":{"$ref":"#/components/responses/NotFound"}}},"patch":{"tags":["collections"],"summary":"Change the owners of a collection","operationId":"set_collection_owners","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"owners":{"description":"The new set of owners for the collection","$ref":"#/components/schemas/Owners"}}}}}},"responses":{"200":{"$ref":"#/components/responses/Owners"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["collections"],"summary":"Remove the current user as a collection's owner","description":"This will fail if this is the last owner of the collection.","operationId":"remove_collection_owner_self","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/collections/{collection}/owners/{username}":{"parameters":[{"$ref":"#/components/parameters/CollectionId"},{"$ref":"#/components/parameters/Username"}],"post":{"tags":["collections"],"summary":"Add an owner to a collection","description":"This will fail if there are too many owners of the collection","operationId":"add_collection_owner","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Owners"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["collections"],"summary":"Remove a collection's owner","description":"This will fail if this is the last owner of the collection.","operationId":"remove_collection_owner","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Owners"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/collections/{collection}/designs":{"parameters":[{"$ref":"#/components/parameters/CollectionId"}],"get":{"tags":["collections"],"summary":"Get the designs of a collection","operationId":"get_collection_designs","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Tags"},{"$ref":"#/components/parameters/Customizable"},{"$ref":"#/components/parameters/HasSingle"},{"$ref":"#/components/parameters/HasMakes"},{"$ref":"#/components/parameters/IsRemix"},{"$ref":"#/components/parameters/Made"},{"$ref":"#/components/parameters/Collected"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfDesigns"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/collections/{collection}/designs/{design}":{"parameters":[{"$ref":"#/components/parameters/CollectionId"},{"$ref":"#/components/parameters/DesignId"}],"post":{"tags":["users"],"summary":"Add a design to a collection","operationId":"add_design_to_collection","security":[{"jwt":[]}],"responses":{"200":{"description":"was already in collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"201":{"description":"added to collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["users"],"summary":"Remove a design from a collection","operationId":"remove_design_from_collection","security":[{"jwt":[]}],"responses":{"200":{"description":"was already not in the collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"201":{"description":"removed from the collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profile/collections":{"get":{"tags":["collections"],"summary":"Get the collections of the current user","operationId":"get_collections_self","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Liked"}],"security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/PageOfCollections"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profiles/{username}/collections":{"parameters":[{"$ref":"#/components/parameters/Username"}],"get":{"tags":["collections"],"summary":"Get the collections of a user","operationId":"get_collections_by","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfCollections"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/collections":{"parameters":[{"$ref":"#/components/parameters/DesignId"}],"get":{"tags":["collections"],"summary":"Get the list of collections that have a particular design (as pages)","operationId":"get_design_collections","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"}],"responses":{"200":{"$ref":"#/components/responses/PageOfCollections"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/collections-by/me":{"parameters":[{"$ref":"#/components/parameters/DesignId"}],"get":{"tags":["collections"],"summary":"Get the list of collections that have a particular design and owned by the current user (as pages)","operationId":"get_design_collections_self","security":[{"jwt":[]}],"parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"}],"responses":{"200":{"$ref":"#/components/responses/PageOfCollections"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/collections-by/<username>":{"parameters":[{"$ref":"#/components/parameters/DesignId"},{"$ref":"#/components/parameters/Username"}],"get":{"tags":["collections"],"summary":"Get the list of collections that have a particular design and owned by a particular user (as pages)","operationId":"get_design_collections_by","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"}],"responses":{"200":{"$ref":"#/components/responses/PageOfCollections"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/image":{"parameters":[{"$ref":"#/components/parameters/DesignId"}],"post":{"tags":["designs"],"summary":"Upload an image into a design","operationId":"add_design_image","security":[{"jwt":[]}],"requestBody":{"$ref":"#/components/requestBodies/AddImage"},"responses":{"201":{"$ref":"#/components/responses/Design"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/images":{"parameters":[{"$ref":"#/components/parameters/DesignId"}],"put":{"tags":["designs"],"summary":"Reorder the images of a design","description":"Send a list of the image links in the order they should be displayed, any links not included will be placed at the end","security":[{"jwt":[]}],"operationId":"reorder_design_images","requestBody":{"description":"list of image links","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}}},"responses":{"200":{"$ref":"#/components/responses/Design"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"patch":{"parameters":[{"$ref":"#/components/parameters/ImageLink"}],"tags":["designs"],"summary":"Update an image in a design","operationId":"update_design_image","security":[{"jwt":[]}],"requestBody":{"$ref":"#/components/requestBodies/UpdateImage"},"responses":{"201":{"$ref":"#/components/responses/Design"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"parameters":[{"$ref":"#/components/parameters/ImageLinks"}],"tags":["designs"],"summary":"Delete images from a design","operationId":"remove_design_images","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Design"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/makes/{make}/image":{"parameters":[{"$ref":"#/components/parameters/MakeId"}],"post":{"tags":["makes"],"summary":"Upload an image into a make","operationId":"add_make_image","security":[{"jwt":[]}],"requestBody":{"$ref":"#/components/requestBodies/AddImage"},"responses":{"201":{"$ref":"#/components/responses/Make"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/makes/{make}/images":{"parameters":[{"$ref":"#/components/parameters/MakeId"}],"put":{"tags":["makes"],"summary":"Reorder the images of a make","description":"Send a list of the image links in the order they should be displayed, any links not included will be placed at the end","security":[{"jwt":[]}],"operationId":"reorder_make_images","requestBody":{"description":"list of image links","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}}},"responses":{"200":{"$ref":"#/components/responses/Make"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"patch":{"parameters":[{"$ref":"#/components/parameters/ImageLink"}],"tags":["makes"],"summary":"Update an image in a make","operationId":"update_make_image","security":[{"jwt":[]}],"requestBody":{"$ref":"#/components/requestBodies/UpdateImage"},"responses":{"201":{"$ref":"#/components/responses/Make"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"parameters":[{"$ref":"#/components/parameters/ImageLinks"}],"tags":["makes"],"summary":"Delete images from a make","operationId":"remove_make_images","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Make"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/comment":{"parameters":[{"$ref":"#/components/parameters/DesignId"}],"post":{"tags":["designs"],"summary":"Add a new comment to a design","operationId":"add_design_comment","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"description":"text for this comment","type":"string","format":"html","maxLength":8192},"reply_to":{"description":"id of comment being replied to","type":"integer"}}}}}},"responses":{"200":{"$ref":"#/components/responses/DesignComment"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/comments":{"parameters":[{"$ref":"#/components/parameters/DesignId"}],"get":{"tags":["designs"],"summary":"Get the comments of a design","description":"Comment pages involve nested paging since each comment can have replies","operationId":"get_design_comments","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/MaxDepth"},{"$ref":"#/components/parameters/ReplyLimit"}],"responses":{"200":{"$ref":"#/components/responses/PageOfDesignComments"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/comments/{comment}":{"parameters":[{"$ref":"#/components/parameters/DesignId"},{"$ref":"#/components/parameters/CommentId"}],"patch":{"tags":["designs"],"summary":"Update a comment on a design","operationId":"update_design_comment","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"description":"text for this comment","type":"string","format":"html","maxLength":8192}}}}}},"responses":{"200":{"$ref":"#/components/responses/DesignComment"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["designs"],"summary":"Remove a comment on a design","description":"If the comment has replies, it is not removed but instead the text and username are replaced with [deleted]","operationId":"remove_design_comment","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/comments/{comment}/reply":{"parameters":[{"$ref":"#/components/parameters/DesignId"},{"$ref":"#/components/parameters/CommentId"}],"post":{"tags":["designs"],"summary":"Add a new reply to a comment on a design","operationId":"add_design_comment_reply","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"description":"text for this comment","type":"string","format":"html","maxLength":8192}}}}}},"responses":{"200":{"$ref":"#/components/responses/DesignComment"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/comments/{comment}/replies":{"parameters":[{"$ref":"#/components/parameters/DesignId"},{"$ref":"#/components/parameters/CommentId"}],"get":{"tags":["designs"],"summary":"Get the reply comments of a design","description":"This endpoint is for dealing with the nested paging of comments","operationId":"get_design_comments_replies","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/MaxDepth"},{"$ref":"#/components/parameters/ReplyLimit"}],"responses":{"200":{"$ref":"#/components/responses/PageOfDesignComments"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/makes/{make}/comment":{"parameters":[{"$ref":"#/components/parameters/MakeId"}],"post":{"tags":["makes"],"summary":"Add a new comment to a make","operationId":"add_make_comment","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"description":"text for this comment","type":"string","format":"html","maxLength":8192},"reply_to":{"description":"id of comment being replied to","type":"integer"}}}}}},"responses":{"200":{"$ref":"#/components/responses/MakeComment"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/makes/{make}/comments":{"parameters":[{"$ref":"#/components/parameters/MakeId"}],"get":{"tags":["makes"],"summary":"Get the comments of a make","description":"Comment pages involve nested paging since each comment can have replies","operationId":"get_make_comments","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/MaxDepth"},{"$ref":"#/components/parameters/ReplyLimit"}],"responses":{"200":{"$ref":"#/components/responses/PageOfMakeComments"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/makes/{make}/comments/{comment}":{"parameters":[{"$ref":"#/components/parameters/MakeId"},{"$ref":"#/components/parameters/CommentId"}],"patch":{"tags":["makes"],"summary":"Update a comment on a make","operationId":"update_make_comment","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"description":"text for this comment","type":"string","format":"html","maxLength":8192}}}}}},"responses":{"200":{"$ref":"#/components/responses/MakeComment"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["makes"],"summary":"Remove a comment on a make","description":"If the comment has replies, it is not removed but instead the text and username are replaced with [deleted]","operationId":"remove_make_comment","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/makes/{make}/comments/{comment}/reply":{"parameters":[{"$ref":"#/components/parameters/MakeId"},{"$ref":"#/components/parameters/CommentId"}],"post":{"tags":["makes"],"summary":"Add a new reply to a comment on a make","operationId":"add_make_comment_reply","security":[{"jwt":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"description":"text for this comment","type":"string","format":"html","maxLength":8192}}}}}},"responses":{"200":{"$ref":"#/components/responses/MakeComment"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/makes/{make}/comments/{comment}/replies":{"parameters":[{"$ref":"#/components/parameters/MakeId"},{"$ref":"#/components/parameters/CommentId"}],"get":{"tags":["makes"],"summary":"Get the reply comments of a make","description":"This endpoint is for dealing with the nested paging of comments","operationId":"get_make_comments_replies","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/MaxDepth"},{"$ref":"#/components/parameters/ReplyLimit"}],"responses":{"200":{"$ref":"#/components/responses/PageOfMakeComments"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profile/likes":{"get":{"tags":["likes"],"summary":"Get the list of designs, makes, and collections liked by the current user (as pages)","description":"The sort only supports the most basic \"newest\" and \"likes\"; other filters only apply to items that support them","operationId":"get_liked","security":[{"jwt":[]}],"parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Tags"},{"$ref":"#/components/parameters/Customizable"},{"$ref":"#/components/parameters/HasSingle"},{"$ref":"#/components/parameters/HasMakes"},{"$ref":"#/components/parameters/IsRemix"},{"$ref":"#/components/parameters/Made"},{"$ref":"#/components/parameters/Collected"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfItems"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/profiles/{username}/likes":{"parameters":[{"$ref":"#/components/parameters/Username"}],"get":{"tags":["likes"],"summary":"Get the list of designs, makes, and collections liked by a user (as pages)","description":"The sort only supports the most basic \"newest\" and \"likes\"; other filters only apply to items that support them; search is not supported","operationId":"get_liked_by","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Tags"},{"$ref":"#/components/parameters/Customizable"},{"$ref":"#/components/parameters/HasSingle"},{"$ref":"#/components/parameters/HasMakes"},{"$ref":"#/components/parameters/IsRemix"},{"$ref":"#/components/parameters/Made"},{"$ref":"#/components/parameters/Collected"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfItems"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profile/likes/designs":{"get":{"tags":["likes"],"summary":"Get the list of designs liked by the current user (as pages)","operationId":"get_liked_designs","security":[{"jwt":[]}],"parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Tags"},{"$ref":"#/components/parameters/Customizable"},{"$ref":"#/components/parameters/HasSingle"},{"$ref":"#/components/parameters/HasMakes"},{"$ref":"#/components/parameters/IsRemix"},{"$ref":"#/components/parameters/Made"},{"$ref":"#/components/parameters/Collected"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfDesigns"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/profiles/{username}/likes/designs":{"parameters":[{"$ref":"#/components/parameters/Username"}],"get":{"tags":["likes"],"summary":"Get the list of designs liked by a user (as pages)","operationId":"get_liked_designs_by","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Tags"},{"$ref":"#/components/parameters/Customizable"},{"$ref":"#/components/parameters/HasSingle"},{"$ref":"#/components/parameters/HasMakes"},{"$ref":"#/components/parameters/IsRemix"},{"$ref":"#/components/parameters/Made"},{"$ref":"#/components/parameters/Collected"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfDesigns"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/like":{"parameters":[{"$ref":"#/components/parameters/DesignId"}],"get":{"tags":["likes"],"summary":"Get if the current user likes a design","operationId":"is_design_liked","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Boolean"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["likes"],"summary":"Mark that the current user likes a design","operationId":"like_design","security":[{"jwt":[]}],"responses":{"200":{"description":"design was already liked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"201":{"description":"liked design","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["likes"],"summary":"Un-Mark that the current user likes a design","operationId":"unlike_design","security":[{"jwt":[]}],"responses":{"200":{"description":"design was already not liked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"201":{"description":"no longer liked design","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/designs/{design}/liked-by/{username}":{"parameters":[{"$ref":"#/components/parameters/DesignId"},{"$ref":"#/components/parameters/Username"}],"get":{"tags":["likes"],"summary":"Get if the user likes a design","operationId":"is_design_liked_by","responses":{"200":{"$ref":"#/components/responses/Boolean"}}}},"/designs/{design}/likes":{"parameters":[{"$ref":"#/components/parameters/DesignId"}],"get":{"tags":["likes"],"summary":"Get the list of users who like a design (as pages)","operationId":"get_design_likes","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Roles"},{"$ref":"#/components/parameters/AllRoles"}],"responses":{"200":{"$ref":"#/components/responses/PageOfProfiles"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profile/likes/collections":{"get":{"tags":["likes"],"summary":"Get the list of collections liked by the current user (as pages)","operationId":"get_liked_collections","security":[{"jwt":[]}],"parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfCollections"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/profiles/{username}/likes/collections":{"parameters":[{"$ref":"#/components/parameters/Username"}],"get":{"tags":["likes"],"summary":"Get the list of collections liked by a user (as pages)","operationId":"get_liked_collections_by","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfCollections"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/collections/{collection}/like":{"parameters":[{"$ref":"#/components/parameters/Username"},{"$ref":"#/components/parameters/CollectionId"}],"get":{"tags":["likes"],"summary":"Get if the current user likes a collection","operationId":"is_collection_liked","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Boolean"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"post":{"tags":["likes"],"summary":"Mark that the current user likes a collection","operationId":"like_collection","security":[{"jwt":[]}],"responses":{"200":{"description":"collection was already liked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"201":{"description":"liked collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["likes"],"summary":"Un-Mark that the current user likes a collection","operationId":"unlike_collection","security":[{"jwt":[]}],"responses":{"200":{"description":"collection was already not liked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"201":{"description":"no longer liked collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/collections/{collection}/liked-by/{username}":{"parameters":[{"$ref":"#/components/parameters/Username"},{"$ref":"#/components/parameters/CollectionId"}],"get":{"tags":["likes"],"summary":"Get if the user likes a collection","operationId":"is_collection_liked_by","responses":{"200":{"$ref":"#/components/responses/Boolean"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/collections/{collection}/likes":{"parameters":[{"$ref":"#/components/parameters/Username"},{"$ref":"#/components/parameters/CollectionId"}],"get":{"tags":["likes"],"summary":"Get the list of users who like a collection (as pages)","operationId":"get_collection_likes","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Roles"},{"$ref":"#/components/parameters/AllRoles"}],"responses":{"200":{"$ref":"#/components/responses/PageOfProfiles"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profile/likes/makes":{"get":{"tags":["likes"],"summary":"Get the list of makes liked by the current user (as pages)","operationId":"get_liked_makes","security":[{"jwt":[]}],"parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfMakes"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/profiles/{username}/likes/makes":{"parameters":[{"$ref":"#/components/parameters/Username"}],"get":{"tags":["likes"],"summary":"Get the list of makes liked by a user (as pages)","operationId":"get_liked_makes_by","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfMakes"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/makes/{make}/like":{"parameters":[{"$ref":"#/components/parameters/DesignId"},{"$ref":"#/components/parameters/MakeId"}],"get":{"tags":["likes"],"summary":"Get if the current user likes a make","operationId":"is_make_liked","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Boolean"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"post":{"tags":["likes"],"summary":"Mark that the current user likes a make","operationId":"like_make","security":[{"jwt":[]}],"responses":{"200":{"description":"make was already liked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"201":{"description":"liked make","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["likes"],"summary":"Un-Mark that the current user likes a make","operationId":"unlike_make","security":[{"jwt":[]}],"responses":{"200":{"description":"make was already not liked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"201":{"description":"no longer liked make","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/makes/{make}/liked-by/{username}":{"parameters":[{"$ref":"#/components/parameters/MakeId"},{"$ref":"#/components/parameters/Username"}],"get":{"tags":["likes"],"summary":"Get if the user likes a make","operationId":"is_make_liked_by","responses":{"200":{"$ref":"#/components/responses/Boolean"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/makes/{make}/likes":{"parameters":[{"$ref":"#/components/parameters/DesignId"},{"$ref":"#/components/parameters/MakeId"}],"get":{"tags":["likes"],"summary":"Get the list of users who like a make (as pages)","operationId":"get_make_likes","parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Roles"},{"$ref":"#/components/parameters/AllRoles"}],"responses":{"200":{"$ref":"#/components/responses/PageOfProfiles"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profile/watches":{"delete":{"tags":["watches"],"summary":"Unwatch all designs and collections","operationId":"unwatch_all","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"201":{"$ref":"#/components/responses/Success"}}}},"/profile/watches/designs":{"get":{"tags":["watches"],"summary":"Get the list of designs watched by the current user (as pages)","operationId":"get_watched_designs","security":[{"jwt":[]}],"parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Tags"},{"$ref":"#/components/parameters/Customizable"},{"$ref":"#/components/parameters/HasSingle"},{"$ref":"#/components/parameters/HasMakes"},{"$ref":"#/components/parameters/IsRemix"},{"$ref":"#/components/parameters/Made"},{"$ref":"#/components/parameters/Collected"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfDesigns"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["watches"],"summary":"Unwatch all designs","operationId":"unwatch_all_designs","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"201":{"$ref":"#/components/responses/Success"}}}},"/designs/{design}/watch":{"parameters":[{"$ref":"#/components/parameters/DesignId"}],"get":{"tags":["watches"],"summary":"Get if the current user is watching a design","operationId":"is_design_watched","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Boolean"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["watches"],"summary":"Have the current user watch a design","operationId":"watch_design","security":[{"jwt":[]}],"responses":{"200":{"description":"design was already watched","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"201":{"description":"watching design","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["watches"],"summary":"Stop the current user from watching a design","operationId":"unwatch_design","security":[{"jwt":[]}],"responses":{"200":{"description":"design was already not watched","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"201":{"description":"no longer watching design","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profile/watches/collections":{"get":{"tags":["watches"],"summary":"Get the list of collections watched by the current user (as pages)","operationId":"get_watched_collections","security":[{"jwt":[]}],"parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfCollections"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["watches"],"summary":"Unwatch all collections","operationId":"unwatch_all_collections","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"201":{"$ref":"#/components/responses/Success"}}}},"/collections/{collection}/watch":{"parameters":[{"$ref":"#/components/parameters/CollectionId"}],"get":{"tags":["watches"],"summary":"Get if the current user is watching a collection","operationId":"is_collection_watched","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Boolean"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"post":{"tags":["watches"],"summary":"Have the current user watch a collection","operationId":"watch_collection","security":[{"jwt":[]}],"responses":{"200":{"description":"collection was already watched","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"201":{"description":"watching collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["watches"],"summary":"Stop the current user from watching a collection","operationId":"unwatch_collection","security":[{"jwt":[]}],"responses":{"200":{"description":"collection was already not watched","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"201":{"description":"no longer watching collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/profile/watches/makes":{"get":{"tags":["watches"],"summary":"Get the list of makes watched by the current user (as pages)","operationId":"get_watched_makes","security":[{"jwt":[]}],"parameters":[{"$ref":"#/components/parameters/Start"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Reverse"},{"$ref":"#/components/parameters/Roles"},{"$ref":"#/components/parameters/AllRoles"},{"$ref":"#/components/parameters/Liked"}],"responses":{"200":{"$ref":"#/components/responses/PageOfMakes"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["watches"],"summary":"Unwatch all makes","operationId":"unwatch_all_makes","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Success"},"201":{"$ref":"#/components/responses/Success"}}}},"/makes/{make}/watch":{"parameters":[{"$ref":"#/components/parameters/MakeId"}],"get":{"tags":["watches"],"summary":"Get if the current user is watching a make","operationId":"is_make_watched","security":[{"jwt":[]}],"responses":{"200":{"$ref":"#/components/responses/Boolean"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"post":{"tags":["watches"],"summary":"Have the current user watch a make","operationId":"watch_make","security":[{"jwt":[]}],"responses":{"200":{"description":"make was already watched","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"201":{"description":"watching make","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["watches"],"summary":"Stop the current user from watching a make","operationId":"unwatch_make","security":[{"jwt":[]}],"responses":{"200":{"description":"make was already not watched","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"201":{"description":"no longer watching make","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}}},"components":{"schemas":{"Error":{"required":["code","name","error"],"properties":{"code":{"type":"integer"},"name":{"type":"string"},"error":{"type":"string"}}},"Message":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}},"Page":{"type":"object","required":["start","limit"],"properties":{"start":{"type":"integer","default":0},"limit":{"type":"integer","default":0}}},"PageWithTotal":{"type":"object","required":["start","limit"],"properties":{"start":{"type":"integer","default":0},"limit":{"type":"integer","default":0},"total":{"description":"total number of entries available, may be an estimate","type":"integer"}}},"LoginTokens":{"type":"object","required":["access_token","refresh_token"],"properties":{"access_token":{"type":"string","description":"the JWT access token for maintaining logged-in state"},"refresh_token":{"type":"string","description":"the JWT refresh token for maintaining logged-in state"}}},"User":{"type":"object","required":["username","email","verified","subscriptions"],"properties":{"username":{"description":"case-insensitive string containing letters, numbers, and the symbols -_.~'` (although . and ~ are not allowed as the first or last character); minimum of 5 characters, maximum of 64 characters","type":"string","example":"coder-for-life","pattern":"^[a-zA-Z0-9_~`'-][a-zA-Z0-9_~`'.-]{3,62}[a-zA-Z0-9_~`'-]$"},"email":{"type":"string","format":"email","example":"bushj@moravian.edu"},"verified":{"type":"boolean","description":"true if the user has verified their email address, false otherwise"},"subscriptions":{"$ref":"#/components/schemas/SubscriptionOptions"},"permissions":{"$ref":"#/components/schemas/Permissions"},"watch_update_freq":{"$ref":"#/components/schemas/UpdateFrequency"},"next_watch_update":{"type":"string","format":"date-time","default":null}}},"Permission":{"type":"string","enum":["access-users","lock-user","unlock-user","grant-permission","modify-profiles","modify-licenses","modify-tags","modify-designs","modify-collections","modify-makes","modify-comments","ALL"]},"Permissions":{"type":"array","description":"optional list of special permissions for this user; most users will have none and this entry will not be provided at all; in general these are never shown to the user but instead change which options the user can see","example":[],"items":{"$ref":"#/components/schemas/Permission"},"uniqueItems":true},"SubscriptionOption":{"type":"string","enum":["new-comment-on-design","new-comment-on-import","new-comment-on-make","remix-of-design","remix-of-import","makes-import","reply-to-comment","design-added-to-collection","import-added-to-collection","message-received"]},"SubscriptionOptions":{"type":"array","description":"list of subscription options for this user","example":["new-comment-on-design","new-comment-on-import","new-comment-on-make","remix-of-design","remix-of-import","makes-import","reply-to-comment","design-added-to-collection","import-added-to-collection"],"items":{"$ref":"#/components/schemas/SubscriptionOption"},"uniqueItems":true},"UpdateFrequency":{"type":"string","enum":["daily","weekly","monthly"]},"Profile":{"description":"A user's profile.","type":"object","required":["username","created","tagline","cover","avatar","roles","favorites","counts","bio"],"properties":{"username":{"type":"string","example":"coder-for-life"},"created":{"type":"integer","example":1672549200,"description":"UNIX timestamp of when the account was created"},"tagline":{"type":"string","example":"Professor of Computer Science, Moravian University","default":""},"cover":{"type":"string","format":"url","example":"https://3dadapt.xyz/photos/cover/abcdef.webp","description":"URL of cover photo, if the URL is the same, the photo is the same, and a cache can be used"},"avatar":{"type":"string","format":"url","example":"https://3dadapt.xyz/photos/avatar/abcdef.webp","description":"URL of avatar photo, if the URL is the same, the photo is the same, and a cache can be used"},"roles":{"$ref":"#/components/schemas/Roles"},"favorites":{"description":"favorite items, these are items that are owned/created by this user that they wish to show off","type":"array","maxLength":6,"items":{"$ref":"#/components/schemas/ItemRef"},"example":[{"type":"collection","id":"things-to-print"},{"type:":"design","id":"assistive-bottle-opener"}]},"following":{"description":"if the current user is following this user, not populated at all if no logged in","type":"boolean","default":false},"counts":{"description":"The number of things that this user has done/selected","type":"object","required":["likes","designs","makes","collections","followers","following"],"properties":{"likes":{"type":"integer"},"designs":{"type":"integer"},"makes":{"type":"integer"},"collections":{"type":"integer"},"followers":{"type":"integer"},"following":{"type":"integer"}}},"bio":{"type":"string","example":"Can be a very long string describing the person, <b>their goals with this app</b>, and whatever...","format":"html","maxLength":16384,"description":"HTML formatted, max length of 16384 characters"}}},"Role":{"type":"string","enum":["client","caregiver","clinician","maker","designer","student","educator"]},"Roles":{"description":"A list of roles that this user has selected","type":"array","example":["designer"],"items":{"$ref":"#/components/schemas/Role"},"uniqueItems":true},"License":{"type":"object","required":["name","desc","text","link","image","properties"],"properties":{"name":{"type":"string","example":"CC-BY-NC-ND"},"desc":{"type":"string","example":"Creative Commons - Attribution - Non-Commercial - No Derivatives","maxLength":255},"text":{"type":"string","example":"Full text of the license...","maxLength":32768},"link":{"type":"string","format":"url","example":"https://creativecommons.org/licenses/by-nc-nd/4.0/"},"image":{"type":"string","format":"url","example":"https://licensebuttons.net/l/by-nc-nd/4.0/88x31.png"},"properties":{"description":"A list of properties for this license. These should be used to add additional icons\nalong with provide warnings to the user when they attempt to download the files\n(along with forcing the user to check off boxes saying they agree). Some (like non-com)\nmay also trigger check-off during purchases.\n","type":"array","example":["attr-req","no-deriv","non-com"],"items":{"$ref":"#/components/schemas/LicenseProperty"},"uniqueItems":true},"deprecated":{"type":"boolean","default":false,"description":"The license is still in use by designs but should not be offered on lists when creating new designs"}}},"LicenseProperty":{"type":"string","description":"* share-alike: must use the same license on any derived works  \n  use the icon at https://mirrors.creativecommons.org/presskit/icons/sa.svg\n* attr-req: must attribute any uses to the original designer  \n  use the icon at https://mirrors.creativecommons.org/presskit/icons/by.svg\n* non-com: all uses must be non-commercial in nature  \n  use the icon at https://mirrors.creativecommons.org/presskit/icons/nc.svg    \n  if not present, possibly use the above icon but without the slash\n* no-deriv: no derivation/remixes are allowed to be shared  \n  use the icon at https://mirrors.creativecommons.org/presskit/icons/nd.svg  \n  if not present, possibly use https://mirrors.creativecommons.org/presskit/icons/remix.svg\n","enum":["share-alike","attr-req","non-com","no-deriv"]},"ReportBrief":{"type":"object","required":["id","type","item","details","submittedBy","submittedAt","resolved"],"properties":{"id":{"description":"The unique identifier for this report","type":"string"},"type":{"$ref":"#/components/schemas/ReportItemType"},"item":{"description":"The identifier of the thing being reported, for a profile this is the username, for for others this is their ID","type":"string","example":"coder-for-life"},"comment_id":{"description":"The identifier of the comment, if the type is a comment","type":"integer"},"details":{"description":"The detailed information about what is inappropriate about the content","type":"string","maxLength":8192},"submittedBy":{"description":"The username of the account that submitted the report","type":"string"},"submittedAt":{"description":"The date-time the report was submitted","type":"string","format":"date-time"},"resolved":{"description":"If the report has been resolved","type":"boolean","default":false},"resolvedAt":{"description":"The date-time the report was marked resolved, or null/not included if not resolved","type":"string","format":"date-time"},"lastUpdated":{"description":"The date-time the report was last updated (either submitted, commented, or resolved)","type":"string","format":"date-time"},"commentCount":{"description":"The number of comments","type":"integer","default":0}}},"Report":{"allOf":[{"$ref":"#/components/schemas/ReportBrief"},{"type":"object","properties":{"comments":{"description":"List of comments about the report","type":"array","items":{"type":"object","properties":{"text":{"description":"The text of the comment","type":"string","maxLength":8192},"who":{"description":"The submitter of the comment","type":"string","example":"coder-for-life"},"when":{"description":"When the comment was submitted","type":"string","format":"date-time"}}}}}}]},"ReportItemType":{"description":"The type of thing being reported","type":"string","enum":["profile","design","make","collection","comment"],"example":"profile"},"Category":{"type":"object","required":["id","name"],"properties":{"id":{"description":"The ID used in a Tag to refer to this category, not shown to user","type":"string","example":"env"},"name":{"description":"The name of this category, shown to the user","type":"string","example":"Environmental Factors"},"order":{"description":"The sort order of the categories, if not provided, will sort last","type":"integer","example":3}}},"Tag":{"type":"object","description":"A tag for a design","required":["id","category","short","name"],"properties":{"id":{"description":"The ID for this tag, either the ICF code or another short, cryptic, string","type":"string","example":"d329"},"code":{"description":"The ICF code, or null if it doesn't have an official code","type":"string","example":"d329","default":null},"category":{"description":"The category of the tag, one of the category IDs","type":"string","example":"env"},"short":{"description":"The short name of the tag to show users","type":"string","example":"Receiving"},"name":{"description":"The name of the tag","type":"string","example":"Communication - Receiving"},"desc":{"description":"The long description of the tag to show as \"more information\"","type":"string","default":""}}},"ItemBase":{"description":"Common base for designs, makes, and collections","type":"object","required":["id","name","by","cover","created","updated","likes","desc"],"properties":{"id":{"description":"unique id for this item, assigned automatically based on the name; it is unique within a class of items","type":"string","example":"assistive-bottle-opener","maxLength":64},"name":{"description":"human-readable name for this item, not necessarily unique; makes always have the same name of their design","type":"string","example":"Assistive Bottle Opener","maxLength":255},"by":{"description":"the \"by\" for this item, for a design this is the author, for a make this is the maker, for a collection this is a joined list of owners","type":"object","required":["name","avatar","external"],"properties":{"name":{"description":"the name of the user(s)","type":"string"},"avatar":{"description":"the URL of the image for the user; for multiple users this is one of them randomly","type":"string","format":"url"},"external":{"description":"if this is an external user","type":"boolean","default":false},"link":{"description":"if this is an external user, a link to their profile","type":"string","format":"url"}}},"cover":{"description":"URL to the cover photo for this item","type":"string","format":"url","example":"https://3dadapt.xyz/images/abcdef.webp"},"created":{"description":"when this item was created; for designs this may be when it was created on an external site","type":"string","format":"datetime","example":"2023-01-10T02:06:19.432000"},"updated":{"description":"when this item was last updated; for designs this may be when it was last updated on an external site","type":"string","format":"datetime","example":"2023-01-10T02:06:19.432000"},"likes":{"description":"number of likes an item has","type":"integer","minimum":0,"default":0},"liked":{"description":"if the current user has liked this item, not populated at all if not logged in","type":"boolean","default":false},"desc":{"description":"description of the item","type":"string","format":"html","maxLength":8192}}},"Design":{"allOf":[{"$ref":"#/components/schemas/ItemBase"},{"description":"A device design. The liked, watching, and collected fields are not populated when the design is returned in response to being created or updated. The desc is not populated except when a single design is requested directly.","type":"object","required":["purpose","submitter","tags","license","files","printsets"],"properties":{"external":{"$ref":"#/components/schemas/External"},"purpose":{"description":"short string describing the purpose of this design","type":"string","example":"Helps you open a bottle","maxLength":255},"submitter":{"description":"User who submitted the design; if an internal design, this is the author","type":"string","example":"coder-for-life","default":null},"moderator":{"description":"User who approved the design; null when first created and unpublished","type":"string","example":"coder-for-life","default":null},"published":{"description":"if this design has been published and is visible to everyone instead of just the author and moderator","type":"boolean","default":false},"tags":{"description":"the list of tags assigned to this design","type":"array","items":{"type":"string"},"default":[]},"watching":{"description":"if the current user is watching this design, not populated at all if not logged in","type":"boolean","default":false},"collected":{"description":"if the current user has collected this design, not populated at all if not logged in","type":"boolean","default":false},"collections":{"description":"number of collections the design is in","type":"integer","minimum":0,"default":0},"comments":{"description":"number of comments/questions the design has","type":"integer","minimum":0,"default":0},"remixes":{"description":"number of remixes of this design","type":"integer","minimum":0,"default":0},"makes":{"description":"number of makes of this design","type":"integer","minimum":0,"default":0},"remix_of":{"description":"the design id of what this design was remixed from, or null","type":"string","default":null},"customizable":{"description":"if the design can be customized","type":"boolean","default":false},"license":{"description":"a license id","type":"string","example":"CC-BY-NC-ND"},"ratings":{"$ref":"#/components/schemas/DesignRatings"},"rating":{"description":"Average of the valid ratings or 0 if none are valid","type":"number","minimum":0,"maximum":5,"default":0},"images":{"description":"list of images","type":"array","items":{"$ref":"#/components/schemas/Image"},"maxLength":25},"files":{"description":"files of this design","type":"array","items":{"$ref":"#/components/schemas/File"}},"printsets":{"description":"printsets of this design","type":"array","items":{"$ref":"#/components/schemas/Printset"}}}}]},"External":{"description":"if this design is defined externally and simply referenced on this site this is included with additional information about the source","type":"object","required":["author","link","created","updated"],"properties":{"author":{"$ref":"#/components/schemas/ExternalAuthor"},"link":{"description":"the link to the original source of the design","type":"string","format":"url","example":"https://www.thingiverse.com/thing:5517149"},"created":{"description":"when this design was created on the external site","type":"string","format":"datetime","example":"2023-01-10T02:06:19.432000"},"updated":{"description":"when this item was last updated on the external site","type":"string","format":"datetime","example":"2023-01-10T02:06:19.432000"},"name":{"description":"the name of this item on the external site; defaults to using the name of the design on this site","type":"string","maxLength":255,"default":null}},"default":null},"ExternalAuthor":{"description":"The author of a design from another site","type":"object","required":["name","avatar","profile"],"properties":{"name":{"description":"Author's username on the other site","type":"string","example":"coder-for-life","minLength":5,"maxLength":64},"avatar":{"description":"Author's avatar image as a URL","type":"string","format":"url","example":"https://cdn.thingiverse.com/site/img/default/avatar/avatar_default_thumb_medium.jpg"},"profile":{"description":"Link to the external profile","type":"string","format":"url","example":"https://www.thingiverse.com/coderforlife"}}},"DesignRatings":{"description":"List of rating summary lining up with the first 8 QUEST questions","type":"array","minLength":8,"maxLength":8,"items":{"$ref":"#/components/schemas/DesignRating"}},"DesignRating":{"description":"Individual rating summary from all makes for this design","type":"object","properties":{"sum":{"type":"integer","minimum":0,"default":0},"count":{"type":"integer","minimum":0,"default":0}}},"Make":{"allOf":[{"$ref":"#/components/schemas/ItemBase"},{"description":"A make of a design. The liked field is not populated when the collection is returned in response to being created or updated. The desc is not populated except when a single make is requested directly.","required":["design","maker","comments","images","ratings","rating"],"type":"object","properties":{"design":{"description":"design this was made from","type":"string","example":"assistive-bottle-opener","maxLength":64},"maker":{"description":"the username of the user who created this","type":"string","example":"coder-for-life","maxLength":64},"comments":{"description":"number of comments the make has","type":"integer","minimum":0,"default":0},"images":{"description":"list of images","type":"array","items":{"$ref":"#/components/schemas/Image"},"maxLength":25},"ratings":{"$ref":"#/components/schemas/MakeRatings"},"rating":{"description":"Average of the valid ratings or 0 if none are valid","type":"number","minimum":0,"maximum":5,"default":0}}}]},"MakeRatings":{"description":"List of ratings lining up with the first 8 QUEST questions","type":"array","minLength":8,"maxLength":8,"items":{"$ref":"#/components/schemas/MakeRating"}},"MakeRating":{"description":"Individual rating out of 5 (or 0 for unanswered) with an optional comment","type":"object","required":["value"],"properties":{"value":{"type":"integer","minimum":0,"maximum":5},"comment":{"type":"string","maxLength":1024,"default":""}}},"Collection":{"type":"object","description":"A collection of items. The liked and watched fields are not populated when the collection is returned in response to being created, updated, or changing owners. The desc is not populated except when a single make is requested directly.","required":["owners","count"],"properties":{"owners":{"$ref":"#/components/schemas/Owners"},"watching":{"description":"if the current user is watching this collection, not populated at all if not logged in","type":"boolean","default":false},"count":{"description":"number of designs in the collection","type":"integer","default":0},"cover_item":{"description":"The id of the design to use for the \"cover\" image; must be in the collection","type":"string","example":"my-first-design","default":null}}},"Owners":{"description":"list of usernames that are the owners/curators of a collection","type":"array","items":{"type":"string"},"maxLength":10},"Item":{"oneOf":[{"allOf":[{"type":"object","required":["type"],"properties":{"type":{"type":"string","example":"design","enum":["design"],"default":"design"}}},{"$ref":"#/components/schemas/Design"}]},{"allOf":[{"type":"object","required":["type"],"properties":{"type":{"type":"string","example":"collection","enum":["collection"],"default":"collection"}}},{"$ref":"#/components/schemas/Collection"}]},{"allOf":[{"type":"object","required":["type"],"properties":{"type":{"type":"string","example":"make","enum":["make"],"default":"make"}}},{"$ref":"#/components/schemas/Make"}]}]},"ItemRef":{"description":"A reference to an item","type":"object","required":["type","id"],"properties":{"type":{"description":"the type of item","type":"string","enum":["design","collection","make"],"example":"collection"},"id":{"description":"the id of the item","type":"string","example":"things-to-print"}}},"Image":{"type":"object","required":["name","link"],"properties":{"name":{"description":"name/description of the image, used as alt text","type":"string","minLength":3,"maxLength":255},"link":{"description":"link to the image","type":"string"},"file":{"description":"the file id if generated from a file","type":"string","default":null}}},"File":{"type":"object","required":["design","id","name","img","usage","possible_usages","created","updated","handler"],"properties":{"design":{"description":"design the file is from","type":"string","maxLength":64},"id":{"description":"id of the file, unique within a design, automatically derived from the name","type":"string","maxLength":64},"name":{"description":"filename (or URL for things like OnShape) of the file","type":"string","maxLength":255},"external":{"description":"if the link is an external source (like OnShape) or can be downloaded from","type":"boolean","default":false},"link":{"description":"link to download the data from or to go to if external","type":"string","maxLength":255},"img":{"description":"link to the static image for the file, will be one of the design's image links; this image also have an alternative that has the _(res).png replaced with .vao.gz for the 3D model","type":"string","maxLength":255},"stl":{"description":"link to download the adjusted STL (scaled and centered)","type":"string","maxLength":255},"desc":{"description":"human-readable description","type":"string","maxLength":255,"default":""},"usage":{"$ref":"#/components/schemas/FileUsage"},"possible_usages":{"description":"the possible usages of the file","type":"array","items":{"$ref":"#/components/schemas/FileUsage"}},"scale":{"description":"the scale of the file when printing","type":"number","default":1.0},"created":{"description":"when this file was uploaded","type":"string","format":"datetime","example":"2023-01-10T02:06:19.432000"},"updated":{"description":"when this file was last updated","type":"string","format":"datetime","example":"2023-01-10T02:06:19.432000"},"handler":{"description":"the handler used to utilize this file internally","type":"string","example":"stl"},"customizations":{"$ref":"#/components/schemas/Customizations"},"size":{"description":"number of bytes in the file, if there is a physical file","type":"integer","example":1024}}},"FileUsage":{"description":"the usage of a file, if not provided it is automatically determined from the name and data","type":"string","enum":["customize","print","other"]},"Printset":{"description":"the print sets available for a design, represent collections of files to be printed together","required":["design","id","name","files","created","updated"],"properties":{"design":{"description":"design the printset is from","type":"string","maxLength":64},"id":{"description":"id of the printset, unique within a design, automatically derived from the name","type":"string","maxLength":64},"name":{"description":"name of the printset","type":"string","maxLength":255},"desc":{"description":"optional description of the printset","type":"string","maxLength":255,"default":""},"files":{"description":"list of file information in this printset","minLength":1,"maxLength":25,"type":"array","items":{"$ref":"#/components/schemas/PrintsetFile"}},"created":{"description":"when this file was uploaded","type":"string","format":"datetime","example":"2023-01-10T02:06:19.432000"},"updated":{"description":"when this file was last updated","type":"string","format":"datetime","example":"2023-01-10T02:06:19.432000"}}},"PrintsetFile":{"description":"a file referenced in a printset","type":"object","required":["id"],"properties":{"id":{"description":"the file id","type":"string","maxLength":64},"scale":{"description":"the scale for this printset, this is multiplied by the scale of the file itself","type":"number","default":1.0},"count":{"description":"the number of times this file needs to be printed for this printset","type":"integer","default":1}}},"Customizations":{"description":"the customizations available for a file or printset, only present if usage is customize","type":"array","items":{"$ref":"#/components/schemas/Customization"}},"Customization":{"description":"a customization available for a file or printset","type":"object","required":["name","default","style"],"properties":{"name":{"description":"valid variable name, if displayed, should convert from snake-case or camel-case to human-readable","type":"string"},"desc":{"description":"human-readable description to use instead of name, if available","type":"string","default":null},"id":{"description":"internal id, not to be displayed, but preserved during requests if provided","type":"string","default":null},"default":{"description":"the default value for the variable","$ref":"#/components/schemas/CustomizationValue"},"group":{"description":"tab group name, or default group if not available; global group is special","type":"string","default":null},"style":{"description":"the style of input to use for this value; determines the other options available","type":"string","enum":["checkbox","dropdown","numbox","textbox"]},"options":{"description":"for dropdown; list or map of options to use; the default value must always but on of the keys (not values)","oneOf":[{"description":"list of options to use, the value is shown and submitted","type":"array","items":{"$ref":"#/components/schemas/CustomizationValue"}},{"description":"map of options to use, the key is shown and value is submitted","type":"object","additionalProperties":{"$ref":"#/components/schemas/CustomizationValue"}}]},"min":{"description":"for numbox; inclusive minimum value, default is no minimum imposed","oneOf":[{"type":"integer"},{"type":"number"}],"default":null},"max":{"description":"for numbox; inclusive maximum value, default is no maximum imposed","oneOf":[{"type":"integer"},{"type":"number"}],"default":null},"inc":{"description":"for numbox; increment between values","oneOf":[{"type":"integer"},{"type":"number"}],"default":1},"max_len":{"description":"for textbox; maximum length of the string allowed, default is no restriction","type":"integer","default":null}}},"CustomizationValues":{"description":"the values used to customize","type":"object","additionalProperties":{"$ref":"#/components/schemas/CustomizationValue"}},"CustomizationValue":{"description":"a value for customization","oneOf":[{"type":"string"},{"type":"integer"},{"type":"number"}]},"CustomizedBase":{"description":"base information about a customized file pr printset","type":"object","required":["design","id","params","status"],"properties":{"design":{"description":"design the file or printset is from","type":"string","maxLength":64},"id":{"description":"id of the file or printset","type":"string","maxLength":64},"params":{"$ref":"#/components/schemas/CustomizationValues"},"status":{"description":"current status of the file","type":"string","enum":["unknown","processing","ready","failed"]},"link":{"description":"the link to download the file, only present if status is ready","type":"string","format":"uri"},"size":{"description":"the size of the file in bytes, only present if status is ready","type":"integer"}}},"CustomizedFile":{"allOf":[{"$ref":"#/components/schemas/CustomizedBase"},{"description":"information about a customized file","type":"object","properties":{"dimensions":{"description":"the dimensions of the file in millimeters, only present if status is ready; never available for printsets","type":"array","items":{"type":"number"}}}}]},"CustomizedPrintset":{"allOf":[{"$ref":"#/components/schemas/CustomizedBase"},{"description":"information about a customized printset","type":"object","required":["files"],"properties":{"files":{"description":"list of customized files in this printset","type":"array","items":{"$ref":"#/components/schemas/CustomizedFile"}}}}]},"Comment":{"description":"A comment for a design or make, can be threaded","type":"object","required":["id","username","avatar","created","updated","text"],"properties":{"id":{"description":"id of this comment, unique for a single design/make","type":"integer"},"username":{"description":"the name of the user who posted this comment","type":"string","example":"coder-for-life"},"avatar":{"description":"the URL avatar of the user who posted this comment","type":"string"},"created":{"description":"when the comment was created","type":"string","format":"datetime"},"updated":{"description":"when the comment was updated","type":"string","format":"datetime"},"text":{"description":"the HTML-formatted text of the comment","type":"string","format":"html","maxLength":8192},"has_replies":{"description":"if this comment has replies to it","type":"boolean","default":false},"reply_to":{"description":"the identifier this comment is a reply to, not populated if in threaded display","type":"integer","default":null},"replies":{"description":"a paged list of replies to this comment, only populated if in threaded display and the max query depth is not reached","type":"object"}}},"DesignComment":{"allOf":[{"$ref":"#/components/schemas/Comment"},{"description":"A comment for a design","required":["design"],"properties":{"design":{"description":"the design id this is a comment for","type":"string","example":"assistive-bottle-opener","maxLength":255}}}]},"MakeComment":{"allOf":[{"$ref":"#/components/schemas/Comment"},{"description":"A comment for a make","required":["make"],"properties":{"make":{"description":"the make id this is a comment for","type":"string","example":"assistive-bottle-opener-001","maxLength":255}}}]}},"requestBodies":{"RawImage":{"content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}},"image/gif":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}}}},"AddImage":{"description":"Adding an image with information requires sending as a multipart/form-data and 'data' must use a file entry; the order value is optional","content":{"multipart/form-data":{"schema":{"type":"object","required":["name","data"],"properties":{"name":{"description":"name/description of the image, used as alt text","type":"string","minLength":3,"maxLength":255},"order":{"description":"the position in the list of images to place the image, if not provided the image will be placed at the end (note: due to limitations of multipart/form-data this will actually be sent as a string, but that it okay)","type":"integer"},"data":{"description":"the image data, must be sent using a file entry","type":"string","format":"binary"}}}}}},"UpdateImage":{"description":"Updating image data with information requires sending as a multipart/form-data and 'data' must use a file entry; all fields are optional and if not provided will not be changed; if not sending image data, can send the other fields just as application/json","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"description":"name/description of the image, used as alt text","type":"string","minLength":3,"maxLength":255}}}},"multipart/form-data":{"schema":{"type":"object","properties":{"name":{"description":"name/description of the image, used as alt text","type":"string","minLength":3,"maxLength":255},"data":{"description":"the image data, must be sent using a file entry","type":"string","format":"binary"}}}}}},"AddFile":{"description":"Adding a file with information requires sending as a multipart/form-data and 'data' must use a file entry; if using an external service like OnShape when data is not needed, a regular JSON request body can be used","content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"description":"the actual filename with extension or URL for things like OnShape","type":"string","maxLength":255},"desc":{"description":"the optional description of the file","type":"string","maxLength":255},"usage":{"$ref":"#/components/schemas/FileUsage"},"scale":{"description":"the optional scaling of the model","type":"number","default":1.0}}}},"multipart/form-data":{"schema":{"type":"object","required":["name"],"properties":{"name":{"description":"the actual filename with extension or URL for things like OnShape","type":"string","maxLength":255},"desc":{"description":"the optional description of the file","type":"string","maxLength":255},"usage":{"$ref":"#/components/schemas/FileUsage"},"scale":{"description":"the optional scaling of the model (note: due to limitations of multipart/form-data this will actually be sent as a string, but that it okay)","type":"number","default":1.0},"data":{"description":"the file data, or not provided for external services like OnShape","type":"string","format":"binary","default":null}}}}}},"UpdateFile":{"description":"Updating file data with information requires sending as a multipart/form-data and 'data' must use a file entry; all fields are optional and if not provided will not be changed; if not sending file data, can send the other fields just as application/json","content":{"application/json":{"schema":{"type":"object","properties":{"desc":{"description":"the optional description of the file","type":"string","maxLength":255},"usage":{"$ref":"#/components/schemas/FileUsage"},"scale":{"description":"the optional scaling of the model","type":"number","default":1.0}}}},"multipart/form-data":{"schema":{"type":"object","properties":{"desc":{"description":"the optional description of the file","type":"string","maxLength":255},"usage":{"$ref":"#/components/schemas/FileUsage"},"scale":{"description":"the optional scaling of the model (note: due to limitations of multipart/form-data this will actually be sent as a string, but that it okay)","type":"number","default":1.0}}}}}}},"responses":{"Success":{"description":"Success (200)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"Boolean":{"description":"A true/false response wrapped in a JSON-able object","content":{"application/json":{"schema":{"type":"object","required":["result"],"properties":{"result":{"type":"boolean"}}}}}},"BadRequest":{"description":"Bad Request (400)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Unauthorized/Bad Login (401) - need to be logged in to access this resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"Forbidden (403) - logged in but the user is not allowed to access the resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Not Found (404)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"TooManyRequests":{"description":"Too Many Requests (429)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Conflict":{"description":"Conflicting Resource (409)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"LoginTokens":{"description":"tokens for maintaining logged in state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginTokens"}}}},"User":{"description":"user information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}}},"Profile":{"description":"profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Profile"}}}},"FavoriteList":{"description":"list of designs, collections, and makes (with properties added to distinguish them)","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Item"}}}}},"Report":{"description":"report","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Report"}}}},"License":{"description":"license","content":{"application/json":{"schema":{"$ref":"#/components/schemas/License"}}}},"Category":{"description":"category","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Category"}}}},"Tag":{"description":"tag","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tag"}}}},"Design":{"description":"Design","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Design"}}}},"Make":{"description":"Make","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Make"}}}},"Collection":{"description":"Collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Collection"}}}},"Owners":{"description":"Owners of a collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Owners"}}}},"Image":{"description":"an image","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Image"}}}},"Images":{"description":"list of images","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Image"}}}}},"File":{"description":"a file","content":{"application/json":{"schema":{"$ref":"#/components/schemas/File"}}}},"Printset":{"description":"a printset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Printset"}}}},"CustomizedFile":{"description":"a customized file","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomizedFile"}}}},"CustomizedPrintset":{"description":"a customized printset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomizedPrintset"}}}},"DesignComment":{"description":"comment for a design","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesignComment"}}}},"MakeComment":{"description":"comment for a make","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MakeComment"}}}},"PageOfProfiles":{"description":"page of profiles","content":{"application/json":{"schema":{"type":"object","required":["page","values"],"properties":{"page":{"$ref":"#/components/schemas/Page"},"values":{"type":"array","items":{"$ref":"#/components/schemas/Profile"}}}}}}},"PageOfDesigns":{"description":"page of designs","content":{"application/json":{"schema":{"type":"object","required":["page","values"],"properties":{"page":{"$ref":"#/components/schemas/Page"},"values":{"type":"array","items":{"$ref":"#/components/schemas/Design"}}}}}}},"PageOfMakes":{"description":"page of makes","content":{"application/json":{"schema":{"type":"object","required":["page","values"],"properties":{"page":{"$ref":"#/components/schemas/Page"},"values":{"type":"array","items":{"$ref":"#/components/schemas/Make"}}}}}}},"PageOfCollections":{"description":"page of collections","content":{"application/json":{"schema":{"type":"object","required":["page","values"],"properties":{"page":{"$ref":"#/components/schemas/Page"},"values":{"type":"array","items":{"$ref":"#/components/schemas/Collection"}}}}}}},"PageOfItems":{"description":"paged list of designs, collections, and makes (with properties added to distinguish them)","content":{"application/json":{"schema":{"type":"object","required":["page","values"],"properties":{"page":{"$ref":"#/components/schemas/Page"},"values":{"type":"array","items":{"$ref":"#/components/schemas/Item"}}}}}}},"PageOfDesignComments":{"description":"paged list of comments, each comment can contain its own pages of comments up to a max depth","content":{"application/json":{"schema":{"type":"object","required":["page","values"],"properties":{"page":{"$ref":"#/components/schemas/Page"},"values":{"type":"array","items":{"$ref":"#/components/schemas/DesignComment"}}}}}}},"PageOfMakeComments":{"description":"paged list of comments, each comment can contain its own pages of comments up to a max depth","content":{"application/json":{"schema":{"type":"object","required":["page","values"],"properties":{"page":{"$ref":"#/components/schemas/Page"},"values":{"type":"array","items":{"$ref":"#/components/schemas/MakeComment"}}}}}}}},"parameters":{"Username":{"in":"path","name":"username","required":true,"schema":{"type":"string"},"example":"coder-for-life"},"ImageLink":{"description":"image link in the query","in":"query","name":"link","required":true,"schema":{"type":"string"}},"ImageLinks":{"description":"list of image links in the query","in":"query","name":"link","required":true,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},"FileId":{"description":"the id of the file","in":"path","name":"id","required":true,"schema":{"type":"string"}},"PrintsetId":{"description":"the id of the printset","in":"path","name":"id","required":true,"schema":{"type":"string"}},"DesignId":{"in":"path","name":"design","required":true,"schema":{"type":"string"},"example":"assistive-bottle-opener"},"MakeId":{"in":"path","name":"make","required":true,"schema":{"type":"string"},"example":"abcde"},"CollectionId":{"in":"path","name":"collection","required":true,"schema":{"type":"string"},"example":"things-to-make"},"CommentId":{"in":"path","name":"comment","required":true,"schema":{"type":"integer"},"example":1},"Start":{"in":"query","name":"start","description":"number of records to skip for pagination","schema":{"type":"integer","minimum":0,"default":0}},"Limit":{"in":"query","name":"limit","description":"maximum number of records to return","schema":{"type":"integer","minimum":0,"maximum":100,"default":50}},"MaxDepth":{"in":"query","name":"max_depth","description":"maximum depth of comment replies to return","schema":{"type":"integer","minimum":0,"maximum":5,"default":2}},"ReplyLimit":{"in":"query","name":"reply_limit","description":"maximum number of direct comment replies to return","schema":{"type":"integer","minimum":0,"maximum":100,"default":10}},"Search":{"in":"query","name":"search","description":"filter results with free text search across the name, purpose, and other textual parts of a design, supports quoted phrases to keep words together, using - to exclude words, and other text searching tools; result order will be biased towards content that matches the search more frequently, especially within the name and purpose","schema":{"type":"string","default":""},"allowEmptyValue":true},"Sort":{"in":"query","name":"sort","description":"sort results, the available options depend on the type of thing being sorted (and sometimes the other arguments\nbeing passed)\n\nprofiles support \"relevance\", \"alphabetical\", \"followers\", \"newest\", \"updated\", \"designs\", \"imports\", \"makes\", \"collections\", \"roles\"\ndesigns support \"relevance\", \"alphabetical\", \"likes\", \"newest\", \"updated\", \"collections\", \"makes\", \"remixes\", \"rating\", \"tags\"\nmakes support \"relevance\", \"alphabetical\", \"likes\", \"newest\", \"updated\", \"rating\"\ncollections support \"relevance\", \"alphabetical\", \"likes\", \"newest\", \"updated\", \"designs\"\n\n\"relevance\" is only supported if a search is also provided\n\"tags\" is only supported if at least one category with multiple tags is provided\n\"roles\" is only supported if there are at least 2 roles provided\n\ndefault sorts by (in this order):\n  - relevance if a search is provided\n  - tags if it is supported (design only)\n  - makes if has_makes filter is true (design only)\n  - roles if it is supported (profile only)\n  - newest\n","schema":{"type":"string","default":"","enum":["","relevance","alphabetical","followers","designs","imports","makes","collections","remixes","likes","rating","newest","updated","tags","roles"]},"allowEmptyValue":true},"Reverse":{"in":"query","name":"customizable","description":"the design has the given value for the customizable field","schema":{"type":"boolean","default":false},"allowEmptyValue":true},"Roles":{"in":"query","name":"roles","description":"filter profile results by a comma-seperated list of roles","schema":{"type":"string","default":"","example":"designer,caregiver"},"allowEmptyValue":true},"AllRoles":{"in":"query","name":"roles","description":"normally, the roles query allows the user to match any of the roles, giving this requires them to match all of the roles","schema":{"type":"boolean","default":false},"allowEmptyValue":true},"Tags":{"in":"query","name":"tags","description":"filter design results by a comma-seperated list of tags; tags within the same category are are compared with \"or\" (so any tag in the same category), tags in different categories are compared with \"and\" (so to match the design must match at least one from each given category)","schema":{"type":"string","default":"","example":"d329,d349,e110"},"allowEmptyValue":true},"HasSingle":{"in":"query","name":"has_single","description":"the design has a printset with a single file in it","schema":{"type":"boolean","default":null},"allowEmptyValue":true},"Customizable":{"in":"query","name":"customizable","description":"the design has the given value for the customizable field","schema":{"type":"boolean","default":null},"allowEmptyValue":true},"HasMakes":{"in":"query","name":"has_makes","description":"require designs to have at least one make if set to true of have no makes if set to false","schema":{"type":"boolean","default":null},"allowEmptyValue":true},"IsRemix":{"in":"query","name":"is_remix","description":"if set to true require designs to be a remix, if set to false require them to not be a remix","schema":{"type":"boolean","default":null},"allowEmptyValue":true},"Made":{"in":"query","name":"made","description":"if set to true require designs to have a make by the current user, if set to false require them to not have one","schema":{"type":"boolean","default":null},"allowEmptyValue":true},"Collected":{"in":"query","name":"collected","description":"if set to true require designs to have be in a collection owned by the current user, if set to false require them to not be in one","schema":{"type":"boolean","default":null},"allowEmptyValue":true},"Liked":{"in":"query","name":"liked","description":"if set to true require item to be liked by the current user, if set to false require them to not be","schema":{"type":"boolean","default":null},"allowEmptyValue":true}},"securitySchemes":{"jwt":{"description":"JWT authorization token","type":"http","scheme":"JWT"}}}}