openapi-directory
Version:
Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS
1 lines • 187 kB
JSON
{"openapi":"3.1.0","servers":[{"url":"http://discourse.local"},{"url":"https://{defaultHost}","variables":{"defaultHost":{"default":"discourse.example.com"}}}],"info":{"description":"This page contains the documentation on how to use Discourse through API calls.\n\n> Note: For any endpoints not listed you can follow the\n[reverse engineer the Discourse API](https://meta.discourse.org/t/-/20576)\nguide to figure out how to use an API endpoint.\n\n### Request Content-Type\n\nThe Content-Type for POST and PUT requests can be set to `application/x-www-form-urlencoded`,\n`multipart/form-data`, or `application/json`.\n\n### Endpoint Names and Response Content-Type\n\nMost API endpoints provide the same content as their HTML counterparts. For example\nthe URL `/categories` serves a list of categories, the `/categories.json` API provides the\nsame information in JSON format.\n\nInstead of sending API requests to `/categories.json` you may also send them to `/categories`\nand add an `Accept: application/json` header to the request to get the JSON response.\nSending requests with the `Accept` header is necessary if you want to use URLs\nfor related endpoints returned by the API, such as pagination URLs.\nThese URLs are returned without the `.json` prefix so you need to add the header in\norder to get the correct response format.\n\n### Authentication\n\nSome endpoints do not require any authentication, pretty much anything else will\nrequire you to be authenticated.\n\nTo become authenticated you will need to create an API Key from the admin panel.\n\nOnce you have your API Key you can pass it in along with your API Username\nas an HTTP header like this:\n\n```\ncurl -X GET \"http://127.0.0.1:3000/admin/users/list/active.json\" \\\n-H \"Api-Key: 714552c6148e1617aeab526d0606184b94a80ec048fc09894ff1a72b740c5f19\" \\\n-H \"Api-Username: system\"\n```\n\nand this is how POST requests will look:\n\n```\ncurl -X POST \"http://127.0.0.1:3000/categories\" \\\n-H \"Content-Type: multipart/form-data;\" \\\n-H \"Api-Key: 714552c6148e1617aeab526d0606184b94a80ec048fc09894ff1a72b740c5f19\" \\\n-H \"Api-Username: system\" \\\n-F \"name=89853c20-4409-e91a-a8ea-f6cdff96aaaa\" \\\n-F \"color=49d9e9\" \\\n-F \"text_color=f0fcfd\"\n```\n\n### Boolean values\n\nIf an endpoint accepts a boolean be sure to specify it as a lowercase\n`true` or `false` value unless noted otherwise.\n","license":{"name":"MIT","url":"https://docs.discourse.org/LICENSE.txt"},"title":"Discourse API Documentation","version":"latest","x-apisguru-categories":["social"],"x-logo":{"url":"https://docs.discourse.org/logo.svg"},"x-origin":[{"format":"openapi","url":"http://docs.discourse.org/openapi.json","version":"3.1"}],"x-providerName":"discourse.local"},"paths":{"/admin/backups.json":{"get":{"operationId":"getBackups","responses":{"200":{"content":{"application/json":{"schema":{"items":{"properties":{"filename":{"type":"string"},"last_modified":{"type":"string"},"size":{"type":"integer"}},"required":["filename","size","last_modified"],"type":"object"},"minItems":1,"type":"array","uniqueItems":true}}},"description":"success response"}},"summary":"List backups","tags":["Backups"]},"post":{"operationId":"createBackup","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"with_uploads":{"type":"boolean"}},"required":["with_uploads"]}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"success":{"examples":["OK"],"type":"string"}},"required":["success"]}}},"description":"success response"}},"summary":"Create backup","tags":["Backups"]}},"/admin/backups/{filename}":{"get":{"operationId":"downloadBackup","parameters":[{"in":"path","name":"filename","required":true,"schema":{"type":"string"}},{"in":"query","name":"token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"success response"}},"summary":"Download backup","tags":["Backups"]},"put":{"operationId":"sendDownloadBackupEmail","parameters":[{"in":"path","name":"filename","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"success response"}},"summary":"Send download backup email","tags":["Backups"]}},"/admin/badges.json":{"get":{"operationId":"adminListBadges","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"admin_badges":{"additionalProperties":false,"properties":{"badge_grouping_ids":{"items":{},"type":"array"},"badge_ids":{"items":{},"type":"array"},"badge_type_ids":{"items":{},"type":"array"},"protected_system_fields":{"items":{},"type":"array"},"triggers":{"additionalProperties":false,"properties":{"none":{"type":"integer"},"post_action":{"type":"integer"},"post_revision":{"type":"integer"},"trust_level_change":{"type":"integer"},"user_change":{"type":"integer"}},"required":["user_change","none","post_revision","trust_level_change","post_action"],"type":"object"}},"required":["protected_system_fields","triggers","badge_ids","badge_grouping_ids","badge_type_ids"],"type":"object"},"badge_groupings":{"items":{"additionalProperties":false,"properties":{"description":{"type":["string","null"]},"id":{"type":"integer"},"name":{"type":"string"},"position":{"type":"integer"},"system":{"type":"boolean"}},"required":["id","name","description","position","system"],"type":"object"},"type":"array"},"badge_types":{"items":{"additionalProperties":false,"properties":{"id":{"type":"integer"},"name":{"type":"string"},"sort_order":{"type":"integer"}},"required":["id","name","sort_order"],"type":"object"},"type":"array"},"badges":{"items":{"additionalProperties":false,"properties":{"allow_title":{"type":"boolean"},"auto_revoke":{"type":"boolean"},"badge_grouping_id":{"type":"integer"},"badge_type_id":{"type":"integer"},"description":{"type":"string"},"enabled":{"type":"boolean"},"grant_count":{"type":"integer"},"i18n_name":{"type":["string","null"]},"icon":{"type":"string"},"id":{"type":"integer"},"image_url":{"type":["string","null"]},"listable":{"type":"boolean"},"long_description":{"type":"string"},"manually_grantable":{"type":"boolean"},"multiple_grant":{"type":"boolean"},"name":{"type":"string"},"query":{"type":["string","null"]},"show_posts":{"type":"boolean"},"slug":{"type":"string"},"system":{"type":"boolean"},"target_posts":{"type":"boolean"},"trigger":{"type":["integer","null"]}},"required":["id","name","description","grant_count","allow_title","multiple_grant","icon","image_url","listable","enabled","badge_grouping_id","system","long_description","slug","manually_grantable","query","trigger","target_posts","auto_revoke","show_posts","badge_type_id"],"type":"object"},"type":"array"}},"required":["badges","badge_types","badge_groupings","admin_badges"]}}},"description":"success response"}},"summary":"List badges","tags":["Badges"]},"post":{"operationId":"createBadge","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"badge_type_id":{"description":"The ID for the badge type. 1 for Gold, 2 for Silver,\n3 for Bronze.","type":"integer"},"name":{"description":"The name for the new badge.","type":"string"}},"required":["name","badge_type_id"]}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"badge":{"additionalProperties":false,"properties":{"allow_title":{"type":"boolean"},"auto_revoke":{"type":"boolean"},"badge_grouping_id":{"type":"integer"},"badge_type_id":{"type":"integer"},"description":{"type":"string"},"enabled":{"type":"boolean"},"grant_count":{"type":"integer"},"icon":{"type":"string"},"id":{"type":"integer"},"image_url":{"type":["string","null"]},"listable":{"type":"boolean"},"long_description":{"type":"string"},"manually_grantable":{"type":"boolean"},"multiple_grant":{"type":"boolean"},"name":{"type":"string"},"query":{"type":["string","null"]},"show_posts":{"type":"boolean"},"slug":{"type":"string"},"system":{"type":"boolean"},"target_posts":{"type":"boolean"},"trigger":{"type":["string","null"]}},"required":["id","name","description","grant_count","allow_title","multiple_grant","icon","image_url","listable","enabled","badge_grouping_id","system","long_description","slug","manually_grantable","query","trigger","target_posts","auto_revoke","show_posts","badge_type_id"],"type":"object"},"badge_types":{"items":{"additionalProperties":false,"properties":{"id":{"type":"integer"},"name":{"type":"string"},"sort_order":{"type":"integer"}},"required":["id","name","sort_order"],"type":"object"},"type":"array"}},"required":["badge_types","badge"]}}},"description":"success response"}},"summary":"Create badge","tags":["Badges"]}},"/admin/badges/{id}.json":{"delete":{"operationId":"deleteBadge","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"success response"}},"summary":"Delete badge","tags":["Badges"]},"put":{"operationId":"updateBadge","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"badge_type_id":{"description":"The ID for the badge type. 1 for Gold, 2 for Silver,\n3 for Bronze.","type":"integer"},"name":{"description":"The name for the new badge.","type":"string"}},"required":["name","badge_type_id"]}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"badge":{"additionalProperties":false,"properties":{"allow_title":{"type":"boolean"},"auto_revoke":{"type":"boolean"},"badge_grouping_id":{"type":"integer"},"badge_type_id":{"type":"integer"},"description":{"type":"string"},"enabled":{"type":"boolean"},"grant_count":{"type":"integer"},"icon":{"type":"string"},"id":{"type":"integer"},"image_url":{"type":["string","null"]},"listable":{"type":"boolean"},"long_description":{"type":"string"},"manually_grantable":{"type":"boolean"},"multiple_grant":{"type":"boolean"},"name":{"type":"string"},"query":{"type":["string","null"]},"show_posts":{"type":"boolean"},"slug":{"type":"string"},"system":{"type":"boolean"},"target_posts":{"type":"boolean"},"trigger":{"type":["string","null"]}},"required":["id","name","description","grant_count","allow_title","multiple_grant","icon","image_url","listable","enabled","badge_grouping_id","system","long_description","slug","manually_grantable","query","trigger","target_posts","auto_revoke","show_posts","badge_type_id"],"type":"object"},"badge_types":{"items":{"additionalProperties":false,"properties":{"id":{"type":"integer"},"name":{"type":"string"},"sort_order":{"type":"integer"}},"required":["id","name","sort_order"],"type":"object"},"type":"array"}},"required":["badge_types","badge"]}}},"description":"success response"}},"summary":"Update badge","tags":["Badges"]}},"/admin/groups.json":{"post":{"operationId":"createGroup","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"group":{"additionalProperties":false,"properties":{"automatic_membership_email_domains":{"description":"pipe|separated","type":"string"},"bio_raw":{"description":"About Group","type":"string"},"default_notification_level":{"type":"integer"},"flair_bg_color":{"type":"string"},"flair_icon":{"type":"string"},"flair_upload_id":{"type":"integer"},"full_name":{"type":"string"},"muted_category_ids":{"items":{"type":"integer"},"type":"array"},"name":{"type":"string"},"owner_usernames":{"description":"comma,separated","type":"string"},"primary_group":{"type":"boolean"},"public_admission":{"type":"boolean"},"public_exit":{"type":"boolean"},"regular_category_ids":{"items":{"type":"integer"},"type":"array"},"tracking_category_ids":{"items":{"type":"integer"},"type":"array"},"usernames":{"description":"comma,separated","type":"string"},"visibility_level":{"type":"integer"},"watching_category_ids":{"items":{"type":"integer"},"type":"array"},"watching_first_post_category_ids":{"items":{"type":"integer"},"type":"array"}},"required":["name"],"type":"object"}},"required":["group"]}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"basic_group":{"additionalProperties":false,"properties":{"allow_membership_requests":{"type":"boolean"},"automatic":{"type":"boolean"},"bio_cooked":{"type":["string","null"]},"bio_excerpt":{"type":["string","null"]},"bio_raw":{"type":["string","null"]},"can_admin_group":{"type":"boolean"},"can_edit_group":{"type":"boolean"},"can_see_members":{"type":"boolean"},"default_notification_level":{"type":"integer"},"flair_bg_color":{"type":["string","null"]},"flair_color":{"type":["string","null"]},"flair_url":{"type":["string","null"]},"full_name":{"type":["string","null"]},"grant_trust_level":{"type":["string","null"]},"has_messages":{"type":"boolean"},"id":{"type":"integer"},"incoming_email":{"type":["string","null"]},"members_visibility_level":{"type":"integer"},"membership_request_template":{"type":["string","null"]},"mentionable_level":{"type":"integer"},"messageable_level":{"type":"integer"},"name":{"type":"string"},"primary_group":{"type":"boolean"},"public_admission":{"type":"boolean"},"public_exit":{"type":"boolean"},"publish_read_state":{"type":"boolean"},"title":{"type":["string","null"]},"user_count":{"type":"integer"},"visibility_level":{"type":"integer"}},"required":["id","automatic","name","user_count","mentionable_level","messageable_level","visibility_level","primary_group","title","grant_trust_level","incoming_email","has_messages","flair_url","flair_bg_color","flair_color","bio_raw","bio_cooked","bio_excerpt","public_admission","public_exit","allow_membership_requests","full_name","default_notification_level","membership_request_template","members_visibility_level","can_see_members","can_admin_group","publish_read_state"],"type":"object"}},"required":["basic_group"]}}},"description":"group created"}},"summary":"Create a group","tags":["Groups"]}},"/admin/groups/{id}.json":{"delete":{"operationId":"deleteGroup","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"success":{"examples":["OK"],"type":"string"}},"required":["success"]}}},"description":"response"}},"summary":"Delete a group","tags":["Groups"]}},"/admin/users/list/{flag}.json":{"get":{"operationId":"adminListUsers","parameters":[{"in":"path","name":"flag","required":true,"schema":{"enum":["active","new","staff","suspended","blocked","suspect"],"type":"string"}},{"in":"query","name":"order","schema":{"enum":["created","last_emailed","seen","username","email","trust_level","days_visited","posts_read","topics_viewed","posts","read_time"],"type":"string"}},{"in":"query","name":"asc","schema":{"enum":["true"],"type":"string"}},{"in":"query","name":"page","schema":{"type":"integer"}},{"in":"query","name":"show_emails","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"properties":{"active":{"type":"boolean"},"admin":{"type":"boolean"},"avatar_template":{"type":"string"},"created_at":{"type":"string"},"created_at_age":{"type":["number","null"]},"days_visited":{"type":"integer"},"email":{"type":"string"},"flag_level":{"type":"integer"},"id":{"type":"integer"},"last_emailed_age":{"type":["number","null"]},"last_emailed_at":{"type":["string","null"]},"last_seen_age":{"type":["number","null"]},"last_seen_at":{"type":["string","null"]},"manual_locked_trust_level":{"type":["string","null"]},"moderator":{"type":"boolean"},"name":{"type":["string","null"]},"post_count":{"type":"integer"},"posts_read_count":{"type":"integer"},"secondary_emails":{"items":{},"type":"array"},"staged":{"type":"boolean"},"time_read":{"type":"integer"},"title":{"type":["string","null"]},"topics_entered":{"type":"integer"},"trust_level":{"type":"integer"},"username":{"type":"string"}},"required":["id","username","name","avatar_template","active","admin","moderator","last_seen_at","last_emailed_at","created_at","last_seen_age","last_emailed_age","created_at_age","trust_level","manual_locked_trust_level","flag_level","title","time_read","staged","days_visited","posts_read_count","topics_entered","post_count"],"type":"object"},"minItems":1,"type":"array","uniqueItems":true}}},"description":"response"}},"summary":"Get a list of users","tags":["Users","Admin"]}},"/admin/users/{id}.json":{"delete":{"operationId":"deleteUser","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"block_email":{"type":"boolean"},"block_ip":{"type":"boolean"},"block_urls":{"type":"boolean"},"delete_posts":{"type":"boolean"}}}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"deleted":{"type":"boolean"}},"required":["deleted"]}}},"description":"response"}},"summary":"Delete a user","tags":["Users","Admin"]},"get":{"operationId":"adminGetUser","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"active":{"type":"boolean"},"admin":{"type":"boolean"},"api_key_count":{"type":"integer"},"approved_by":{"additionalProperties":false,"properties":{"avatar_template":{"type":"string"},"id":{"type":"integer"},"name":{"type":"string"},"username":{"type":"string"}},"required":["id","username","name","avatar_template"],"type":["object","null"]},"associated_accounts":{"items":{},"type":"array"},"avatar_template":{"type":"string"},"badge_count":{"type":"integer"},"bounce_score":{"type":["integer","null"]},"can_activate":{"type":"boolean"},"can_be_anonymized":{"type":"boolean"},"can_be_deleted":{"type":"boolean"},"can_be_merged":{"type":"boolean"},"can_deactivate":{"type":"boolean"},"can_delete_all_posts":{"type":"boolean"},"can_delete_sso_record":{"type":"boolean"},"can_disable_second_factor":{"type":"boolean"},"can_grant_admin":{"type":"boolean"},"can_grant_moderation":{"type":"boolean"},"can_impersonate":{"type":"boolean"},"can_revoke_admin":{"type":"boolean"},"can_revoke_moderation":{"type":"boolean"},"can_send_activation_email":{"type":"boolean"},"can_view_action_logs":{"type":"boolean"},"created_at":{"type":"string"},"created_at_age":{"type":["number","null"]},"days_visited":{"type":"integer"},"external_ids":{"type":"object"},"flag_level":{"type":"integer"},"flags_given_count":{"type":"integer"},"flags_received_count":{"type":"integer"},"full_suspend_reason":{"type":["string","null"]},"groups":{"items":{"additionalProperties":false,"properties":{"allow_membership_requests":{"type":"boolean"},"automatic":{"type":"boolean"},"bio_cooked":{"type":["string","null"]},"bio_excerpt":{"type":["string","null"]},"bio_raw":{"type":["string","null"]},"can_admin_group":{"type":"boolean"},"can_see_members":{"type":"boolean"},"default_notification_level":{"type":"integer"},"display_name":{"type":"string"},"flair_bg_color":{"type":["string","null"]},"flair_color":{"type":["string","null"]},"flair_url":{"type":["string","null"]},"full_name":{"type":["string","null"]},"grant_trust_level":{"type":["string","null"]},"has_messages":{"type":"boolean"},"id":{"type":"integer"},"incoming_email":{"type":["string","null"]},"members_visibility_level":{"type":"integer"},"membership_request_template":{"type":["string","null"]},"mentionable_level":{"type":"integer"},"messageable_level":{"type":"integer"},"name":{"type":"string"},"primary_group":{"type":"boolean"},"public_admission":{"type":"boolean"},"public_exit":{"type":"boolean"},"publish_read_state":{"type":"boolean"},"title":{"type":["string","null"]},"user_count":{"type":"integer"},"visibility_level":{"type":"integer"}},"required":["id","automatic","name","display_name","user_count","mentionable_level","messageable_level","visibility_level","primary_group","title","grant_trust_level","incoming_email","has_messages","flair_url","flair_bg_color","flair_color","bio_raw","bio_cooked","bio_excerpt","public_admission","public_exit","allow_membership_requests","full_name","default_notification_level","membership_request_template","members_visibility_level","can_see_members","can_admin_group","publish_read_state"],"type":"object"},"type":"array"},"id":{"type":"integer"},"ip_address":{"type":"string"},"last_emailed_age":{"type":["number","null"]},"last_emailed_at":{"type":["string","null"]},"last_seen_age":{"type":["number","null"]},"last_seen_at":{"type":["string","null"]},"like_count":{"type":"integer"},"like_given_count":{"type":"integer"},"manual_locked_trust_level":{"type":["string","null"]},"moderator":{"type":"boolean"},"name":{"type":["string","null"]},"next_penalty":{"type":"string"},"penalty_counts":{"additionalProperties":false,"properties":{"silenced":{"type":"integer"},"suspended":{"type":"integer"}},"required":["silenced","suspended"],"type":"object"},"post_count":{"type":"integer"},"post_edits_count":{"type":["integer","null"]},"posts_read_count":{"type":"integer"},"primary_group_id":{"type":["string","null"]},"private_topics_count":{"type":"integer"},"registration_ip_address":{"type":["string","null"]},"reset_bounce_score_after":{"type":["string","null"]},"silence_reason":{"type":["string","null"]},"silenced_by":{"type":["string","null"]},"single_sign_on_record":{"type":["string","null"]},"staged":{"type":"boolean"},"suspended_by":{"type":["string","null"]},"time_read":{"type":"integer"},"title":{"type":["string","null"]},"tl3_requirements":{"additionalProperties":false,"properties":{"days_visited":{"type":"integer"},"max_flagged_by_users":{"type":"integer"},"max_flagged_posts":{"type":"integer"},"min_days_visited":{"type":"integer"},"min_likes_given":{"type":"integer"},"min_likes_received":{"type":"integer"},"min_likes_received_days":{"type":"integer"},"min_likes_received_users":{"type":"integer"},"min_posts_read":{"type":"integer"},"min_posts_read_all_time":{"type":"integer"},"min_topics_replied_to":{"type":"integer"},"min_topics_viewed":{"type":"integer"},"min_topics_viewed_all_time":{"type":"integer"},"num_flagged_by_users":{"type":"integer"},"num_flagged_posts":{"type":"integer"},"num_likes_given":{"type":"integer"},"num_likes_received":{"type":"integer"},"num_likes_received_days":{"type":"integer"},"num_likes_received_users":{"type":"integer"},"num_topics_replied_to":{"type":"integer"},"on_grace_period":{"type":"boolean"},"penalty_counts":{"additionalProperties":false,"properties":{"silenced":{"type":"integer"},"suspended":{"type":"integer"},"total":{"type":"integer"}},"required":["silenced","suspended","total"],"type":"object"},"posts_read":{"type":"integer"},"posts_read_all_time":{"type":"integer"},"requirements_lost":{"type":"boolean"},"requirements_met":{"type":"boolean"},"time_period":{"type":"integer"},"topics_viewed":{"type":"integer"},"topics_viewed_all_time":{"type":"integer"},"trust_level_locked":{"type":"boolean"}},"required":["time_period","requirements_met","requirements_lost","trust_level_locked","on_grace_period","days_visited","min_days_visited","num_topics_replied_to","min_topics_replied_to","topics_viewed","min_topics_viewed","posts_read","min_posts_read","topics_viewed_all_time","min_topics_viewed_all_time","posts_read_all_time","min_posts_read_all_time","num_flagged_posts","max_flagged_posts","num_flagged_by_users","max_flagged_by_users","num_likes_given","min_likes_given","num_likes_received","min_likes_received","num_likes_received_days","min_likes_received_days","num_likes_received_users","min_likes_received_users","penalty_counts"],"type":"object"},"topic_count":{"type":"integer"},"topics_entered":{"type":"integer"},"trust_level":{"type":"integer"},"username":{"type":"string"},"warnings_received_count":{"type":"integer"}},"required":["id","username","name","avatar_template","active","admin","moderator","last_seen_at","last_emailed_at","created_at","last_seen_age","last_emailed_age","created_at_age","trust_level","manual_locked_trust_level","flag_level","title","time_read","staged","days_visited","posts_read_count","topics_entered","post_count","can_send_activation_email","can_activate","can_deactivate","ip_address","registration_ip_address","can_grant_admin","can_revoke_admin","can_grant_moderation","can_revoke_moderation","can_impersonate","like_count","like_given_count","topic_count","flags_given_count","flags_received_count","private_topics_count","can_delete_all_posts","can_be_deleted","can_be_anonymized","can_be_merged","full_suspend_reason","silence_reason","primary_group_id","badge_count","warnings_received_count","bounce_score","reset_bounce_score_after","can_view_action_logs","can_disable_second_factor","can_delete_sso_record","api_key_count","single_sign_on_record","approved_by","suspended_by","silenced_by","groups","external_ids"]}}},"description":"response"}},"summary":"Get a user by id","tags":["Users","Admin"]}},"/admin/users/{id}/anonymize.json":{"put":{"operationId":"anonymizeUser","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"success":{"type":"string"},"username":{"type":"string"}},"required":["success","username"]}}},"description":"response"}},"summary":"Anonymize a user","tags":["Users","Admin"]}},"/admin/users/{id}/log_out.json":{"post":{"operationId":"logOutUser","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"success":{"examples":["OK"],"type":"string"}},"required":["success"]}}},"description":"response"}},"summary":"Log a user out","tags":["Users","Admin"]}},"/admin/users/{id}/silence.json":{"put":{"operationId":"silenceUser","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"message":{"description":"Will send an email with this message when present","type":"string"},"post_action":{"examples":["delete"],"type":"string"},"reason":{"type":"string"},"silenced_till":{"examples":["2025-06-15T13:47:52.733Z"],"type":"string"}}}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"silence":{"additionalProperties":false,"properties":{"silence_reason":{"type":"string"},"silenced":{"type":"boolean"},"silenced_at":{"type":"string"},"silenced_by":{"additionalProperties":false,"properties":{"avatar_template":{"type":"string"},"id":{"type":"integer"},"name":{"type":"string"},"username":{"type":"string"}},"required":["id","username","name","avatar_template"],"type":"object"},"silenced_till":{"type":"string"}},"required":["silenced","silence_reason","silenced_till","silenced_at","silenced_by"],"type":"object"}},"required":["silence"]}}},"description":"response"}},"summary":"Silence a user","tags":["Users","Admin"]}},"/admin/users/{id}/suspend.json":{"put":{"operationId":"suspendUser","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"message":{"description":"Will send an email with this message when present","type":"string"},"post_action":{"examples":["delete"],"type":"string"},"reason":{"type":"string"},"suspend_until":{"examples":["2025-06-15T13:47:52.733Z"],"type":"string"}},"required":["suspend_until","reason"]}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"suspension":{"additionalProperties":false,"properties":{"full_suspend_reason":{"type":"string"},"suspend_reason":{"type":"string"},"suspended_at":{"type":"string"},"suspended_by":{"additionalProperties":false,"properties":{"avatar_template":{"type":"string"},"id":{"type":"integer"},"name":{"type":"string"},"username":{"type":"string"}},"required":["id","username","name","avatar_template"],"type":"object"},"suspended_till":{"type":"string"}},"required":["suspend_reason","full_suspend_reason","suspended_till","suspended_at","suspended_by"],"type":"object"}},"required":["suspension"]}}},"description":"response"}},"summary":"Suspend a user","tags":["Users","Admin"]}},"/c/{id}/show.json":{"get":{"operationId":"getCategory","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"category":{"additionalProperties":false,"properties":{"all_topics_wiki":{"type":"boolean"},"allow_badges":{"type":"boolean"},"allow_global_tags":{"type":"boolean"},"allow_unlimited_owner_edits_on_first_post":{"type":"boolean"},"allowed_tag_groups":{"items":{},"type":"array"},"allowed_tags":{"items":{},"type":"array"},"auto_close_based_on_last_post":{"type":"boolean"},"auto_close_hours":{"type":["string","null"]},"available_groups":{"items":{},"type":"array"},"can_delete":{"type":"boolean"},"can_edit":{"type":"boolean"},"category_setting":{"auto_bump_cooldown_days":1,"num_auto_bump_daily":null,"require_reply_approval":null,"require_topic_approval":null},"color":{"type":"string"},"custom_fields":{"additionalProperties":false,"properties":{},"type":"object"},"default_list_filter":{"type":"string"},"default_slow_mode_seconds":{"type":["string","null"]},"default_top_period":{"type":"string"},"default_view":{"type":["string","null"]},"description":{"type":["string","null"]},"description_excerpt":{"type":["string","null"]},"description_text":{"type":["string","null"]},"email_in":{"type":["string","null"]},"email_in_allow_strangers":{"type":"boolean"},"form_template_ids":{"items":{},"type":"array"},"group_permissions":{"items":{"additionalProperties":false,"properties":{"group_name":{"type":"string"},"permission_type":{"type":"integer"}},"required":["permission_type","group_name"],"type":"object"},"type":"array"},"has_children":{"type":["string","null"]},"id":{"type":"integer"},"mailinglist_mirror":{"type":"boolean"},"minimum_required_tags":{"type":"integer"},"name":{"type":"string"},"navigate_to_first_post_after_read":{"type":"boolean"},"notification_level":{"type":"integer"},"num_featured_topics":{"type":"integer"},"permission":{"type":["integer","null"]},"position":{"type":"integer"},"post_count":{"type":"integer"},"read_only_banner":{"type":["string","null"]},"read_restricted":{"type":"boolean"},"required_tag_groups":{"items":{"additionalProperties":false,"properties":{"min_count":{"type":"integer"},"name":{"type":"string"}},"required":["name","min_count"],"type":"object"},"type":"array"},"search_priority":{"type":"integer"},"show_subcategory_list":{"type":"boolean"},"slug":{"type":"string"},"sort_ascending":{"type":["string","null"]},"sort_order":{"type":["string","null"]},"subcategory_list_style":{"type":"string"},"text_color":{"type":"string"},"topic_count":{"type":"integer"},"topic_featured_link_allowed":{"type":"boolean"},"topic_template":{"type":["string","null"]},"topic_url":{"type":["string","null"]},"uploaded_background":{"type":["string","null"]},"uploaded_logo":{"type":["string","null"]},"uploaded_logo_dark":{"type":["string","null"]}},"required":["id","name","color","text_color","slug","topic_count","post_count","position","description","description_text","description_excerpt","topic_url","read_restricted","permission","notification_level","can_edit","topic_template","has_children","sort_order","sort_ascending","show_subcategory_list","num_featured_topics","default_view","subcategory_list_style","default_top_period","default_list_filter","minimum_required_tags","navigate_to_first_post_after_read","custom_fields","required_tag_groups","read_only_banner","available_groups","auto_close_hours","auto_close_based_on_last_post","allow_unlimited_owner_edits_on_first_post","default_slow_mode_seconds","group_permissions","email_in","email_in_allow_strangers","mailinglist_mirror","all_topics_wiki","can_delete","allow_badges","topic_featured_link_allowed","search_priority","uploaded_logo","uploaded_logo_dark","uploaded_background"],"type":"object"}},"required":["category"]}}},"description":"response"}},"summary":"Show category","tags":["Categories"]}},"/c/{slug}/{id}.json":{"get":{"operationId":"listCategoryTopics","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}},{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"primary_groups":{"items":{},"type":"array"},"topic_list":{"additionalProperties":false,"properties":{"can_create_topic":{"type":"boolean"},"per_page":{"type":"integer"},"top_tags":{"items":{},"type":"array"},"topics":{"items":{"additionalProperties":false,"properties":{"archetype":{"type":"string"},"archived":{"type":"boolean"},"bookmarked":{"type":["string","null"]},"bumped":{"type":"boolean"},"bumped_at":{"type":"string"},"category_id":{"type":"integer"},"closed":{"type":"boolean"},"created_at":{"type":"string"},"excerpt":{"type":"string"},"fancy_title":{"type":"string"},"featured_link":{"type":["string","null"]},"has_summary":{"type":"boolean"},"highest_post_number":{"type":"integer"},"id":{"type":"integer"},"image_url":{"type":["string","null"]},"last_posted_at":{"type":"string"},"last_poster_username":{"type":"string"},"like_count":{"type":"integer"},"liked":{"type":["string","null"]},"pinned":{"type":"boolean"},"pinned_globally":{"type":"boolean"},"posters":{"items":{"additionalProperties":false,"properties":{"description":{"type":"string"},"extras":{"type":"string"},"primary_group_id":{"type":["string","null"]},"user_id":{"type":"integer"}},"required":["extras","description","user_id","primary_group_id"],"type":"object"},"type":"array"},"posts_count":{"type":"integer"},"reply_count":{"type":"integer"},"slug":{"type":"string"},"title":{"type":"string"},"unpinned":{"type":["string","null"]},"unseen":{"type":"boolean"},"views":{"type":"integer"},"visible":{"type":"boolean"}},"required":["id","title","fancy_title","slug","posts_count","reply_count","highest_post_number","image_url","created_at","last_posted_at","bumped","bumped_at","archetype","unseen","pinned","unpinned","excerpt","visible","closed","archived","bookmarked","liked","views","like_count","has_summary","last_poster_username","category_id","pinned_globally","featured_link","posters"],"type":"object"},"type":"array"}},"required":["can_create_topic","per_page","topics"],"type":"object"},"users":{"items":{"additionalProperties":false,"properties":{"avatar_template":{"type":"string"},"id":{"type":"integer"},"name":{"type":"string"},"username":{"type":"string"}},"required":["id","username","name","avatar_template"],"type":"object"},"type":"array"}},"required":["topic_list"]}}},"description":"success response"}},"summary":"List topics","tags":["Categories"]}},"/categories.json":{"get":{"operationId":"listCategories","parameters":[{"in":"query","name":"include_subcategories","schema":{"enum":[true],"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"category_list":{"additionalProperties":false,"properties":{"can_create_category":{"type":"boolean"},"can_create_topic":{"type":"boolean"},"categories":{"items":{"additionalProperties":false,"properties":{"can_edit":{"type":"boolean"},"color":{"type":"string"},"default_list_filter":{"type":"string"},"default_top_period":{"type":"string"},"default_view":{"type":["string","null"]},"description":{"type":["string","null"]},"description_excerpt":{"type":["string","null"]},"description_text":{"type":["string","null"]},"has_children":{"type":"boolean"},"id":{"type":"integer"},"is_uncategorized":{"type":"boolean"},"minimum_required_tags":{"type":"integer"},"name":{"type":"string"},"navigate_to_first_post_after_read":{"type":"boolean"},"notification_level":{"type":"integer"},"num_featured_topics":{"type":"integer"},"permission":{"type":"integer"},"position":{"type":"integer"},"post_count":{"type":"integer"},"read_restricted":{"type":"boolean"},"show_subcategory_list":{"type":"boolean"},"slug":{"type":"string"},"sort_ascending":{"type":["string","null"]},"sort_order":{"type":["string","null"]},"subcategory_ids":{"items":{},"type":"array"},"subcategory_list":{"items":{},"type":["array","null"]},"subcategory_list_style":{"type":"string"},"text_color":{"type":"string"},"topic_count":{"type":"integer"},"topic_template":{"type":["string","null"]},"topic_url":{"type":["string","null"]},"topics_all_time":{"type":"integer"},"topics_day":{"type":"integer"},"topics_month":{"type":"integer"},"topics_week":{"type":"integer"},"topics_year":{"type":"integer"},"uploaded_background":{"type":["string","null"]},"uploaded_logo":{"type":["string","null"]},"uploaded_logo_dark":{"type":["string","null"]}},"required":["id","name","color","text_color","slug","topic_count","post_count","position","description","description_text","description_excerpt","topic_url","read_restricted","permission","notification_level","can_edit","topic_template","has_children","sort_order","sort_ascending","show_subcategory_list","num_featured_topics","default_view","subcategory_list_style","default_top_period","default_list_filter","minimum_required_tags","navigate_to_first_post_after_read","topics_day","topics_week","topics_month","topics_year","topics_all_time","subcategory_ids","uploaded_logo","uploaded_logo_dark","uploaded_background"],"type":"object"},"type":"array"}},"required":["can_create_category","can_create_topic","categories"],"type":"object"}},"required":["category_list"]}}},"description":"success response"}},"summary":"Retrieves a list of categories","tags":["Categories"]},"post":{"operationId":"createCategory","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"allow_badges":{"type":"boolean"},"color":{"examples":["49d9e9"],"type":"string"},"form_template_ids":{"items":{},"type":"array"},"name":{"type":"string"},"parent_category_id":{"type":"integer"},"permissions":{"additionalProperties":true,"properties":{"everyone":{"examples":[1],"type":"integer"},"staff":{"type":"integer"}},"type":"object"},"search_priority":{"type":"integer"},"slug":{"type":"string"},"text_color":{"examples":["f0fcfd"],"type":"string"},"topic_featured_links_allowed":{"type":"boolean"}},"required":["name"]}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"category":{"additionalProperties":false,"properties":{"all_topics_wiki":{"type":"boolean"},"allow_badges":{"type":"boolean"},"allow_global_tags":{"type":"boolean"},"allow_unlimited_owner_edits_on_first_post":{"type":"boolean"},"allowed_tag_groups":{"items":{},"type":"array"},"allowed_tags":{"items":{},"type":"array"},"auto_close_based_on_last_post":{"type":"boolean"},"auto_close_hours":{"type":["string","null"]},"available_groups":{"items":{},"type":"array"},"can_delete":{"type":"boolean"},"can_edit":{"type":"boolean"},"category_setting":{"auto_bump_cooldown_days":1,"num_auto_bump_daily":null,"require_reply_approval":null,"require_topic_approval":null},"color":{"type":"string"},"custom_fields":{"additionalProperties":false,"properties":{},"type":"object"},"default_list_filter":{"type":"string"},"default_slow_mode_seconds":{"type":["string","null"]},"default_top_period":{"type":"string"},"default_view":{"type":["string","null"]},"description":{"type":["string","null"]},"description_excerpt":{"type":["string","null"]},"description_text":{"type":["string","null"]},"email_in":{"type":["string","null"]},"email_in_allow_strangers":{"type":"boolean"},"form_template_ids":{"items":{},"type":"array"},"group_permissions":{"items":{"additionalProperties":false,"properties":{"group_name":{"type":"string"},"permission_type":{"type":"integer"}},"required":["permission_type","group_name"],"type":"object"},"type":"array"},"has_children":{"type":["string","null"]},"id":{"type":"integer"},"mailinglist_mirror":{"type":"boolean"},"minimum_required_tags":{"type":"integer"},"name":{"type":"string"},"navigate_to_first_post_after_read":{"type":"boolean"},"notification_level":{"type":"integer"},"num_featured_topics":{"type":"integer"},"permission":{"type":["integer","null"]},"position":{"type":"integer"},"post_count":{"type":"integer"},"read_only_banner":{"type":["string","null"]},"read_restricted":{"type":"boolean"},"required_tag_groups":{"items":{"additionalProperties":false,"properties":{"min_count":{"type":"integer"},"name":{"type":"string"}},"required":["name","min_count"],"type":"object"},"type":"array"},"search_priority":{"type":"integer"},"show_subcategory_list":{"type":"boolean"},"slug":{"type":"string"},"sort_ascending":{"type":["string","null"]},"sort_order":{"type":["string","null"]},"subcategory_list_style":{"type":"string"},"text_color":{"type":"string"},"topic_count":{"type":"integer"},"topic_featured_link_allowed":{"type":"boolean"},"topic_template":{"type":["string","null"]},"topic_url":{"type":["string","null"]},"uploaded_background":{"type":["string","null"]},"uploaded_logo":{"type":["string","null"]},"uploaded_logo_dark":{"type":["string","null"]}},"required":["id","name","color","text_color","slug","topic_count","post_count","position","description","description_text","description_excerpt","topic_url","read_restricted","permission","notification_level","can_edit","topic_template","has_children","sort_order","sort_ascending","show_subcategory_list","num_featured_topics","default_view","subcategory_list_style","default_top_period","default_list_filter","minimum_required_tags","navigate_to_first_post_after_read","custom_fields","required_tag_groups","read_only_banner","available_groups","auto_close_hours","auto_close_based_on_last_post","allow_unlimited_owner_edits_on_first_post","default_slow_mode_seconds","group_permissions","email_in","email_in_allow_strangers","mailinglist_mirror","all_topics_wiki","can_delete","allow_badges","topic_featured_link_allowed","search_priority","uploaded_logo","uploaded_logo_dark","uploaded_background"],"type":"object"}},"required":["category"]}}},"description":"success response"}},"summary":"Creates a category","tags":["Categories"]}},"/categories/{id}.json":{"put":{"operationId":"updateCategory","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"allow_badges":{"type":"boolean"},"color":{"examples":["49d9e9"],"type":"string"},"form_template_ids":{"items":{},"type":"array"},"name":{"type":"string"},"parent_category_id":{"type":"integer"},"permissions":{"additionalProperties":true,"properties":{"everyone":{"examples":[1],"type":"integer"},"staff":{"type":"integer"}},"type":"object"},"search_priority":{"type":"integer"},"slug":{"type":"string"},"text_color":{"examples":["f0fcfd"],"type":"string"},"topic_featured_links_allowed":{"type":"boolean"}},"required":["name"]}}}},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"category":{"additionalProperties":false,"properties":{"all_topics_wiki":{"type":"boolean"},"allow_badges":{"type":"boolean"},"allow_global_tags":{"type":"boolean"},"allow_unlimited_owner_edits_on_first_post":{"type":"boolean"},"allowed_tag_groups":{"items":{},"type":"array"},"allowed_tags":{"items":{},"type":"array"},"auto_close_based_on_last_post":{"type":"boolean"},"auto_close_hours":{"type":["string","null"]},"available_groups":{"items":{},"type":"array"},"can_delete":{"type":"boolean"},"can_edit":{"type":"boolean"},"category_setting":{"auto_bump_cooldown_days":1,"num_auto_bump_daily":null,"require_reply_approval":null,"require_topic_approval":null},"color":{"type":"string"},"custom_fields":{"additionalProperties":false,"properties":{},"type":"object"},"default_list_filter":{"type":"string"},"default_slow_mode_seconds":{"type":["string","null"]},"default_top_period":{"type":"string"},"default_view":{"type":["string","null"]},"description":{"type":["string","null"]},"description_excerpt":{"type":["string","null"]},"description_text":{"type":["string","null"]},"email_in":{"type":["string","null"]},"email_in_allow_strangers":{"type":"boolean"},"form_template_ids":{"items":{},"type":"array"},"group_permissions":{"items":{"additionalProperties":false,"properties":{"group_name":{"type":"string"},"permission_type":{"type":"integer"}},"required":["permission_type","group_name"],"type":"object"},"type":"array"},"has_children":{"type":["string","null"]},"id":{"type":"integer"},"mailinglist_mirror":{"type":"boolean"},"minimum_required_tags":{"type":"integer"},"name":{"type":"string"},"navigate_to_first_post_after_read":{"type":"boolean"},"notification_level":{"type":"integer"},"num_featured_topics":{"type":"integer"},"permission":{"type":["string","null"]},"position":{"type":"integer"},"post_count":{"type":"integer"},"read_only_banner":{"type":["string","null"]},"read_restricted":{"type":"boolean"},"required_tag_groups":{"items":{"additionalProperties":false,"properties":{"min_count":{"type":"integer"},"name":{"type":"string"}},"required":["name","min_count"],"type":"object"},"type":"array"},"search_priority":{"type":"integer"},"show_subcategory_list":{"type":"boolean"},"slug":{"type":"string"},"sort_ascending":{"type":["string","null"]},"sort_order":{"type":["string","null"]},"subcategory_list_style":{"type":"string"},"text_color":{"type":"string"},"topic_count":{"type":"integer"},"topic_featured_link_allowed":{"type":"boolean"},"topic_template":{"type":["string","null"]},"topic_url":{"type":["string","null"]},"uploaded_background":{"type":["string","null"]},"uploaded_logo":{"type":["string","null"]},"uploaded_logo_dark":{"type":["string","null"]}},"required":["id","name","color","text_color","slug","topic_count","post_count","position","description","description_text","description_excerpt","topic_url","read_restricted","permission","notification_level","can_edit","topic_template","form_template_ids","has_children","sort_order","sort_ascending","show_subcategory_list","num_featured_topics","default_view","subcategory_list_style","default_top_period","default_list_filter","minimum_required_tags","navigate_to_first_post_after_read","custom_fields","required_tag_groups","read_only_banner","available_groups","auto_close_hours","auto_close_based_on_last_post","allow_unlimited_owner_edits_on_first_post","default_slow_mode_seconds","group_permissions","email_in","email_in_allow_strangers","mailinglist_mirror","all_topics_wiki","can_delete","allow_badges","topic_featured_link_allowed","search_priority","uploaded_logo","uploaded_logo_dark","uploaded_background"],"type":"object"},"success":{"type":"string"}},"required":["success","category"]}}},"description":"success response"}},"summary":"Updates a category","tags":["Categories"]}},"/directory_items.json":{"get":{"operationId":"listUsersPublic","parameters":[{"in":"query","name":"period","required":true,"schema":{"enum":["daily","weekly","monthly","quarterly","yearly","all"],"type":"string"}},{"in":"query","name":"order","required":true,"schema":{"enum":["likes_received","likes_given","topic_count","post_count","topics_entered","posts_read","days_visited"],"type":"string"}},{"in":"query","name":"asc","schema":{"enum":["true"],"type":"string"}},{"in":"query","name":"page","schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"directory_items":{"items":{"additionalProperties":false,"properties":{"days_visited":{"type":"integer"},"id":{"type":"integer"},"likes_given":{"type":"integer"},"likes_received":{"type":"integer"},"post_count":{"type":"integer"},"posts_read":{"type":"integer"},"topic_count":{"type":"integer"},"topics_entered":{"type":"integer"},"user":{"additionalProperties":false,"properties":{"avatar_template":{"type":"string"},"id":{"type":"integer"},"name":{"type":["string","null"]},"title":{"type":["string","null"]},"username":{"type":"string"}},"required":["id","username","name","avatar_template","title"],"type":"object"}},"required":["id","likes_received","likes_given","topics_entered","topic_count","post_count","posts_read","days_visited","user"],"type":"object"},"type":"array"},"meta":{"additionalProperties":false,"properties":{"last_updated_at":{"type":["string","null"]},"load_more_directory_items":{"type":"string"},"total_rows_directory_items":{"type":"integer"}},"required":["last_updated_at","total_rows_directory_items","load_more_directory_items"],"type":"object"}},"required":["directory_items","meta"]}}},"description":"directory items response"}},"summary":"Get a public list of users","tags":["Users"]}},"/groups.json":{"get":{"operationId":"listGroups","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"extras":{"additionalProperties":false,"properties":{"type_filters":{"items":{},"type":"array"}},"required":["type_filters"],"type":"object"},"groups":{"items":{"additionalProperties":false,"properties":{"allow_membership_requests":{"type":"boolean"},"automatic":{"type":"boolean"},"bio_cooked":{"type":["string","null"]},"bio_excerpt":{"type":["string","null"]},"bio_raw":{"type":["string","null"]},"can_admin_group":{"type":"boolean"},"can_edit_group":{"type":"boolean"},"can_see_members":{"type":"boolean"},"default_notification_level":{"type":"integer"},"display_name":{"type":"string"},"flair_bg_color":{"type":["string","null"]},"flair_color":{"type":["string","null"]},"flair_url":{"type":["string","null"]},"full_name":{"type":["string","null"]},"grant_trust_level":{"type":["string","null"]},"