{"openapi":"3.0.3","info":{"title":"Brainrot Bible","version":"1.0.0","description":"Current internet slang for AI agents, built from public posts. Every meaning cites the posts that show it. Without a key you read today's 100 free entries; any account reads everything. Each call that reads entries is one query, and returns at most 10 entries: 10 queries a day without a key, 25 with one, reset at midnight UTC. Past that, calls get 429 quota_exceeded."},"servers":[{"url":"https://brainrotbible.ai"}],"components":{"securitySchemes":{"key":{"type":"http","scheme":"bearer","description":"An API key from /account (slang_...)"}}},"security":[{"key":[]},{}],"paths":{"/v1/suggest":{"post":{"operationId":"suggest","summary":"Slang that fits a message your AI is about to send","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"description":"The message your AI is about to send","type":"string","maxLength":4000},"messages":{"description":"The conversation so far, oldest first. When text is absent, the last one is the message being sent.","maxItems":20,"type":"array","items":{"type":"object","properties":{"role":{"type":"string","maxLength":40},"text":{"type":"string","maxLength":4000}},"required":["text"]}},"audience":{"description":"Who it is for, in words: \"gen z gamers\", \"a friend teasing\", \"k-pop stans\"","type":"string","maxLength":200},"filters":{"type":"object","properties":{"kinds":{"description":"Only these kinds","type":"array","items":{"type":"string","enum":["slang","meme","reference","catchphrase","acronym"]}},"categories":{"description":"At least one of these categories (see GET /v1/categories)","type":"array","items":{"type":"string"}},"tones":{"description":"At least one sense is currently used in one of these tones","type":"array","items":{"type":"string","enum":["affectionate","playful","neutral","ironic","derisive","hostile","slur"]}},"trajectories":{"type":"array","items":{"type":"string","enum":["rising","peaking","steady","fading","dormant","unknown"]}},"tags":{"description":"At least one real example shows one of these settings (see GET /v1/tags)","type":"array","items":{"type":"string"}},"fine_with":{"description":"At least one sense is fine with this company or a wider one: \"anyone\" keeps what you could say in class, \"strangers\" adds casual talk, \"friends\" adds in-jokes, \"adults\" adds the explicit. Slurs and dogwhistles (level \"nobody\") never match","type":"string","enum":["anyone","strangers","friends","adults"]},"first_seen_after":{"description":"ISO date","type":"string"},"first_seen_before":{"description":"ISO date","type":"string"},"peak_after":{"description":"ISO date","type":"string"},"peak_before":{"description":"ISO date","type":"string"},"updated_after":{"description":"ISO date","type":"string"},"min_relevance":{"description":"0–100, measured from how much the term is used now","type":"number","minimum":0,"maximum":100},"include_drafts":{"description":"Include entries resting on a single voice so far","type":"boolean"}},"description":"Every filter given must hold."},"limit":{"description":"At most 10, the default","type":"integer","minimum":1,"maximum":10},"include_fading":{"description":"Include terms measured as fading or dormant (off by default)","type":"boolean"},"example_tags":{"description":"Only show examples in these settings","maxItems":20,"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"locked":{"type":"number","description":"Matches hidden because they are not among today's free entries"},"message":{"nullable":true,"type":"string"},"suggestions":{"type":"array","items":{"type":"object","properties":{"term":{"type":"string"},"slug":{"type":"string"},"kind":{"type":"string"},"score":{"type":"number","description":"Closeness in meaning to the message, with a small lift for terms in use now"},"meaning":{"type":"string","description":"The sense that fits"},"clean":{"nullable":true,"description":"That meaning as you would put it to a class, when `meaning` is explicit","type":"string"},"usage":{"type":"string"},"fine_with":{"nullable":true,"description":"The widest company it lands fine with, judged by the people who use it: anyone, strangers, friends or adults, or nobody for a slur or dogwhistle. Null when not yet rated","type":"object","properties":{"level":{"type":"string","enum":["anyone","strangers","friends","adults","nobody"]},"note":{"type":"string","description":"Where it would land badly"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["level","note","sources"]},"tone":{"type":"string"},"used_by":{"type":"string"},"trajectory":{"type":"string"},"relevance":{"type":"number"},"categories":{"type":"array","items":{"type":"string"}},"examples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Quoted word for word from a real post"},"source":{"type":"string"},"url":{"nullable":true,"type":"string"},"posted_at":{"nullable":true,"type":"string"},"tags":{"type":"array","items":{"type":"string"},"description":"The setting the post shows"},"replying_to":{"nullable":true,"description":"What the post replies to (a caption, the post above a comment), or null. Read from the thread it is in, it is the thread's first post, \"…\" when levels are skipped, then the post it answers, one per line as \"author: text\". It explains the post; it is not the post's words","type":"string"}},"required":["text","source","url","posted_at","tags","replying_to"]}},"caution":{"nullable":true,"description":"Crowds that still read it more harshly, when the record shows them","type":"string"}},"required":["term","slug","kind","score","meaning","clean","usage","fine_with","tone","used_by","trajectory","relevance","categories","examples","caution"]}}},"required":["locked","message","suggestions"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/v1/terms":{"get":{"operationId":"listTerms","summary":"Browse, filter and search the dictionary","parameters":[{"name":"q","in":"query","required":false,"description":"Words, a spelling or a description of the meaning","schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"description":"Comma-separated kinds","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Comma-separated categories","schema":{"type":"string"}},{"name":"tone","in":"query","required":false,"description":"Comma-separated current tones","schema":{"type":"string"}},{"name":"trajectory","in":"query","required":false,"description":"Comma-separated trajectories","schema":{"type":"string"}},{"name":"tag","in":"query","required":false,"description":"Comma-separated example tags","schema":{"type":"string"}},{"name":"first_seen_after","in":"query","required":false,"description":"ISO date","schema":{"type":"string"}},{"name":"first_seen_before","in":"query","required":false,"description":"ISO date","schema":{"type":"string"}},{"name":"peak_after","in":"query","required":false,"description":"ISO date","schema":{"type":"string"}},{"name":"peak_before","in":"query","required":false,"description":"ISO date","schema":{"type":"string"}},{"name":"updated_after","in":"query","required":false,"description":"ISO date","schema":{"type":"string"}},{"name":"min_relevance","in":"query","required":false,"description":"0–100","schema":{"type":"string"}},{"name":"include_drafts","in":"query","required":false,"description":"true to include unconfirmed entries","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"relevance (default), recent, first_seen or alpha; ignored with q","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1–10, the default","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"next_cursor from the previous page","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"locked":{"type":"number","description":"Matches hidden because they are not among today's free entries"},"message":{"nullable":true,"type":"string"},"terms":{"type":"array","items":{"type":"object","properties":{"term":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","description":"The entry on the website"},"locked":{"type":"boolean","enum":[false]},"kind":{"type":"string","enum":["slang","meme","reference","catchphrase","acronym"]},"status":{"type":"string","enum":["published","draft"]},"summary":{"type":"string"},"clean_summary":{"nullable":true,"description":"The summary as you would put it to a class, when `summary` is explicit","type":"string"},"variants":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}},"trajectory":{"type":"string","description":"Measured from counts: rising, peaking, steady, fading, dormant or unknown"},"relevance":{"type":"number","description":"0–100, measured from how much the term is used now"},"first_seen":{"nullable":true,"type":"string"},"peak":{"nullable":true,"type":"string"},"wikipedia_views":{"nullable":true,"description":"How often people looked the term up on Wikipedia, by month, when an article about it exists. Lookups, not uses","type":"object","properties":{"article":{"type":"string"},"url":{"type":"string"},"since":{"type":"string","description":"When the article was written; no month before it is counted"},"monthly":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM"},"views":{"type":"number"}},"required":["month","views"]}}},"required":["article","url","since","monthly"]},"updated":{"type":"string"},"confidence":{"type":"string","enum":["low","medium","high"]},"senses":{"type":"array","items":{"type":"object","properties":{"meaning":{"type":"string"},"clean":{"nullable":true,"description":"The meaning as you would put it to a class, when `meaning` is explicit","type":"string"},"usage":{"type":"string"},"fine_with":{"nullable":true,"description":"The widest company it lands fine with, judged by the people who use it: anyone, strangers, friends or adults, or nobody for a slur or dogwhistle. Null when not yet rated","type":"object","properties":{"level":{"type":"string","enum":["anyone","strangers","friends","adults","nobody"]},"note":{"type":"string","description":"Where it would land badly"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["level","note","sources"]},"tone":{"nullable":true,"description":"The current tone (the newest open register period)","type":"string","enum":["affectionate","playful","neutral","ironic","derisive","hostile","slur"]},"used_by":{"nullable":true,"type":"string"},"register":{"type":"array","items":{"type":"object","properties":{"since":{"type":"string"},"until":{"nullable":true,"type":"string"},"where":{"type":"string"},"tone":{"type":"string","enum":["affectionate","playful","neutral","ironic","derisive","hostile","slur"]},"note":{"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["since","until","where","tone","note","sources"]}},"examples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Quoted word for word from a real post"},"source":{"type":"string"},"url":{"nullable":true,"type":"string"},"posted_at":{"nullable":true,"type":"string"},"tags":{"type":"array","items":{"type":"string"},"description":"The setting the post shows"},"replying_to":{"nullable":true,"description":"What the post replies to (a caption, the post above a comment), or null. Read from the thread it is in, it is the thread's first post, \"…\" when levels are skipped, then the post it answers, one per line as \"author: text\". It explains the post; it is not the post's words","type":"string"}},"required":["text","source","url","posted_at","tags","replying_to"]}},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["meaning","clean","usage","fine_with","tone","used_by","register","examples","sources"]}},"parents":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"relation":{"type":"string","enum":["references","remixes","derived_from","blend_of","misspelling_of","response_to"]},"note":{"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["label","relation","note","sources"]}},"origin":{"nullable":true,"type":"object","properties":{"note":{"type":"string"},"date":{"nullable":true,"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["note","date","sources"]},"sources":{"type":"array","items":{"type":"object","properties":{"ref":{"type":"string"},"source":{"type":"string"},"url":{"nullable":true,"type":"string"},"posted_at":{"nullable":true,"type":"string"},"excerpt":{"type":"string"},"replying_to":{"nullable":true,"description":"What the post replies to (a caption, the post above a comment), or null. Read from the thread it is in, it is the thread's first post, \"…\" when levels are skipped, then the post it answers, one per line as \"author: text\". It explains the post; it is not the post's words","type":"string"}},"required":["ref","source","url","posted_at","excerpt","replying_to"]}}},"required":["term","slug","url","locked","kind","status","summary","clean_summary","variants","categories","trajectory","relevance","first_seen","peak","wikipedia_views","updated","confidence","senses","parents","origin","sources"]}},"next_cursor":{"nullable":true,"type":"string"}},"required":["locked","message","terms","next_cursor"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/v1/terms/{term}":{"get":{"operationId":"getTerm","summary":"One entry, by slug or any spelling","parameters":[{"name":"term","in":"path","required":true,"schema":{"type":"string"}},{"name":"include_drafts","in":"query","required":false,"description":"true to include unconfirmed entries","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"term":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","description":"The entry on the website"},"locked":{"type":"boolean","enum":[false]},"kind":{"type":"string","enum":["slang","meme","reference","catchphrase","acronym"]},"status":{"type":"string","enum":["published","draft"]},"summary":{"type":"string"},"clean_summary":{"nullable":true,"description":"The summary as you would put it to a class, when `summary` is explicit","type":"string"},"variants":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}},"trajectory":{"type":"string","description":"Measured from counts: rising, peaking, steady, fading, dormant or unknown"},"relevance":{"type":"number","description":"0–100, measured from how much the term is used now"},"first_seen":{"nullable":true,"type":"string"},"peak":{"nullable":true,"type":"string"},"wikipedia_views":{"nullable":true,"description":"How often people looked the term up on Wikipedia, by month, when an article about it exists. Lookups, not uses","type":"object","properties":{"article":{"type":"string"},"url":{"type":"string"},"since":{"type":"string","description":"When the article was written; no month before it is counted"},"monthly":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM"},"views":{"type":"number"}},"required":["month","views"]}}},"required":["article","url","since","monthly"]},"updated":{"type":"string"},"confidence":{"type":"string","enum":["low","medium","high"]},"senses":{"type":"array","items":{"type":"object","properties":{"meaning":{"type":"string"},"clean":{"nullable":true,"description":"The meaning as you would put it to a class, when `meaning` is explicit","type":"string"},"usage":{"type":"string"},"fine_with":{"nullable":true,"description":"The widest company it lands fine with, judged by the people who use it: anyone, strangers, friends or adults, or nobody for a slur or dogwhistle. Null when not yet rated","type":"object","properties":{"level":{"type":"string","enum":["anyone","strangers","friends","adults","nobody"]},"note":{"type":"string","description":"Where it would land badly"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["level","note","sources"]},"tone":{"nullable":true,"description":"The current tone (the newest open register period)","type":"string","enum":["affectionate","playful","neutral","ironic","derisive","hostile","slur"]},"used_by":{"nullable":true,"type":"string"},"register":{"type":"array","items":{"type":"object","properties":{"since":{"type":"string"},"until":{"nullable":true,"type":"string"},"where":{"type":"string"},"tone":{"type":"string","enum":["affectionate","playful","neutral","ironic","derisive","hostile","slur"]},"note":{"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["since","until","where","tone","note","sources"]}},"examples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Quoted word for word from a real post"},"source":{"type":"string"},"url":{"nullable":true,"type":"string"},"posted_at":{"nullable":true,"type":"string"},"tags":{"type":"array","items":{"type":"string"},"description":"The setting the post shows"},"replying_to":{"nullable":true,"description":"What the post replies to (a caption, the post above a comment), or null. Read from the thread it is in, it is the thread's first post, \"…\" when levels are skipped, then the post it answers, one per line as \"author: text\". It explains the post; it is not the post's words","type":"string"}},"required":["text","source","url","posted_at","tags","replying_to"]}},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["meaning","clean","usage","fine_with","tone","used_by","register","examples","sources"]}},"parents":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"relation":{"type":"string","enum":["references","remixes","derived_from","blend_of","misspelling_of","response_to"]},"note":{"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["label","relation","note","sources"]}},"origin":{"nullable":true,"type":"object","properties":{"note":{"type":"string"},"date":{"nullable":true,"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["note","date","sources"]},"sources":{"type":"array","items":{"type":"object","properties":{"ref":{"type":"string"},"source":{"type":"string"},"url":{"nullable":true,"type":"string"},"posted_at":{"nullable":true,"type":"string"},"excerpt":{"type":"string"},"replying_to":{"nullable":true,"description":"What the post replies to (a caption, the post above a comment), or null. Read from the thread it is in, it is the thread's first post, \"…\" when levels are skipped, then the post it answers, one per line as \"author: text\". It explains the post; it is not the post's words","type":"string"}},"required":["ref","source","url","posted_at","excerpt","replying_to"]}}},"required":["term","slug","url","locked","kind","status","summary","clean_summary","variants","categories","trajectory","relevance","first_seen","peak","wikipedia_views","updated","confidence","senses","parents","origin","sources"]},{"type":"object","properties":{"term":{"type":"string"},"slug":{"type":"string"},"locked":{"type":"boolean","enum":[true]},"message":{"type":"string"},"sign_up_url":{"type":"string"}},"required":["term","slug","locked","message","sign_up_url"]}]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/v1/decode":{"post":{"operationId":"decode","summary":"Every known term a piece of text uses","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":20000},"include_drafts":{"type":"boolean"}},"required":["text"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"matches":{"type":"array","items":{"type":"object","properties":{"matched":{"type":"string"},"term":{"anyOf":[{"type":"object","properties":{"term":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","description":"The entry on the website"},"locked":{"type":"boolean","enum":[false]},"kind":{"type":"string","enum":["slang","meme","reference","catchphrase","acronym"]},"status":{"type":"string","enum":["published","draft"]},"summary":{"type":"string"},"clean_summary":{"nullable":true,"description":"The summary as you would put it to a class, when `summary` is explicit","type":"string"},"variants":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}},"trajectory":{"type":"string","description":"Measured from counts: rising, peaking, steady, fading, dormant or unknown"},"relevance":{"type":"number","description":"0–100, measured from how much the term is used now"},"first_seen":{"nullable":true,"type":"string"},"peak":{"nullable":true,"type":"string"},"wikipedia_views":{"nullable":true,"description":"How often people looked the term up on Wikipedia, by month, when an article about it exists. Lookups, not uses","type":"object","properties":{"article":{"type":"string"},"url":{"type":"string"},"since":{"type":"string","description":"When the article was written; no month before it is counted"},"monthly":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM"},"views":{"type":"number"}},"required":["month","views"]}}},"required":["article","url","since","monthly"]},"updated":{"type":"string"},"confidence":{"type":"string","enum":["low","medium","high"]},"senses":{"type":"array","items":{"type":"object","properties":{"meaning":{"type":"string"},"clean":{"nullable":true,"description":"The meaning as you would put it to a class, when `meaning` is explicit","type":"string"},"usage":{"type":"string"},"fine_with":{"nullable":true,"description":"The widest company it lands fine with, judged by the people who use it: anyone, strangers, friends or adults, or nobody for a slur or dogwhistle. Null when not yet rated","type":"object","properties":{"level":{"type":"string","enum":["anyone","strangers","friends","adults","nobody"]},"note":{"type":"string","description":"Where it would land badly"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["level","note","sources"]},"tone":{"nullable":true,"description":"The current tone (the newest open register period)","type":"string","enum":["affectionate","playful","neutral","ironic","derisive","hostile","slur"]},"used_by":{"nullable":true,"type":"string"},"register":{"type":"array","items":{"type":"object","properties":{"since":{"type":"string"},"until":{"nullable":true,"type":"string"},"where":{"type":"string"},"tone":{"type":"string","enum":["affectionate","playful","neutral","ironic","derisive","hostile","slur"]},"note":{"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["since","until","where","tone","note","sources"]}},"examples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Quoted word for word from a real post"},"source":{"type":"string"},"url":{"nullable":true,"type":"string"},"posted_at":{"nullable":true,"type":"string"},"tags":{"type":"array","items":{"type":"string"},"description":"The setting the post shows"},"replying_to":{"nullable":true,"description":"What the post replies to (a caption, the post above a comment), or null. Read from the thread it is in, it is the thread's first post, \"…\" when levels are skipped, then the post it answers, one per line as \"author: text\". It explains the post; it is not the post's words","type":"string"}},"required":["text","source","url","posted_at","tags","replying_to"]}},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["meaning","clean","usage","fine_with","tone","used_by","register","examples","sources"]}},"parents":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"relation":{"type":"string","enum":["references","remixes","derived_from","blend_of","misspelling_of","response_to"]},"note":{"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["label","relation","note","sources"]}},"origin":{"nullable":true,"type":"object","properties":{"note":{"type":"string"},"date":{"nullable":true,"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["note","date","sources"]},"sources":{"type":"array","items":{"type":"object","properties":{"ref":{"type":"string"},"source":{"type":"string"},"url":{"nullable":true,"type":"string"},"posted_at":{"nullable":true,"type":"string"},"excerpt":{"type":"string"},"replying_to":{"nullable":true,"description":"What the post replies to (a caption, the post above a comment), or null. Read from the thread it is in, it is the thread's first post, \"…\" when levels are skipped, then the post it answers, one per line as \"author: text\". It explains the post; it is not the post's words","type":"string"}},"required":["ref","source","url","posted_at","excerpt","replying_to"]}}},"required":["term","slug","url","locked","kind","status","summary","clean_summary","variants","categories","trajectory","relevance","first_seen","peak","wikipedia_views","updated","confidence","senses","parents","origin","sources"]},{"type":"object","properties":{"term":{"type":"string"},"slug":{"type":"string"},"locked":{"type":"boolean","enum":[true]},"message":{"type":"string"},"sign_up_url":{"type":"string"}},"required":["term","slug","locked","message","sign_up_url"]}]}},"required":["matched","term"]}},"more":{"type":"number","description":"Further terms the text uses, past the first ones returned"}},"required":["matches","more"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/v1/trending":{"get":{"operationId":"trending","summary":"Terms measured as rising or peaking now","parameters":[{"name":"limit","in":"query","required":false,"description":"1–10, the default","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"locked":{"type":"number","description":"Matches hidden because they are not among today's free entries"},"message":{"nullable":true,"type":"string"},"terms":{"type":"array","items":{"type":"object","properties":{"term":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","description":"The entry on the website"},"locked":{"type":"boolean","enum":[false]},"kind":{"type":"string","enum":["slang","meme","reference","catchphrase","acronym"]},"status":{"type":"string","enum":["published","draft"]},"summary":{"type":"string"},"clean_summary":{"nullable":true,"description":"The summary as you would put it to a class, when `summary` is explicit","type":"string"},"variants":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}},"trajectory":{"type":"string","description":"Measured from counts: rising, peaking, steady, fading, dormant or unknown"},"relevance":{"type":"number","description":"0–100, measured from how much the term is used now"},"first_seen":{"nullable":true,"type":"string"},"peak":{"nullable":true,"type":"string"},"wikipedia_views":{"nullable":true,"description":"How often people looked the term up on Wikipedia, by month, when an article about it exists. Lookups, not uses","type":"object","properties":{"article":{"type":"string"},"url":{"type":"string"},"since":{"type":"string","description":"When the article was written; no month before it is counted"},"monthly":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM"},"views":{"type":"number"}},"required":["month","views"]}}},"required":["article","url","since","monthly"]},"updated":{"type":"string"},"confidence":{"type":"string","enum":["low","medium","high"]},"senses":{"type":"array","items":{"type":"object","properties":{"meaning":{"type":"string"},"clean":{"nullable":true,"description":"The meaning as you would put it to a class, when `meaning` is explicit","type":"string"},"usage":{"type":"string"},"fine_with":{"nullable":true,"description":"The widest company it lands fine with, judged by the people who use it: anyone, strangers, friends or adults, or nobody for a slur or dogwhistle. Null when not yet rated","type":"object","properties":{"level":{"type":"string","enum":["anyone","strangers","friends","adults","nobody"]},"note":{"type":"string","description":"Where it would land badly"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["level","note","sources"]},"tone":{"nullable":true,"description":"The current tone (the newest open register period)","type":"string","enum":["affectionate","playful","neutral","ironic","derisive","hostile","slur"]},"used_by":{"nullable":true,"type":"string"},"register":{"type":"array","items":{"type":"object","properties":{"since":{"type":"string"},"until":{"nullable":true,"type":"string"},"where":{"type":"string"},"tone":{"type":"string","enum":["affectionate","playful","neutral","ironic","derisive","hostile","slur"]},"note":{"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["since","until","where","tone","note","sources"]}},"examples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Quoted word for word from a real post"},"source":{"type":"string"},"url":{"nullable":true,"type":"string"},"posted_at":{"nullable":true,"type":"string"},"tags":{"type":"array","items":{"type":"string"},"description":"The setting the post shows"},"replying_to":{"nullable":true,"description":"What the post replies to (a caption, the post above a comment), or null. Read from the thread it is in, it is the thread's first post, \"…\" when levels are skipped, then the post it answers, one per line as \"author: text\". It explains the post; it is not the post's words","type":"string"}},"required":["text","source","url","posted_at","tags","replying_to"]}},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["meaning","clean","usage","fine_with","tone","used_by","register","examples","sources"]}},"parents":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"relation":{"type":"string","enum":["references","remixes","derived_from","blend_of","misspelling_of","response_to"]},"note":{"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["label","relation","note","sources"]}},"origin":{"nullable":true,"type":"object","properties":{"note":{"type":"string"},"date":{"nullable":true,"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["note","date","sources"]},"sources":{"type":"array","items":{"type":"object","properties":{"ref":{"type":"string"},"source":{"type":"string"},"url":{"nullable":true,"type":"string"},"posted_at":{"nullable":true,"type":"string"},"excerpt":{"type":"string"},"replying_to":{"nullable":true,"description":"What the post replies to (a caption, the post above a comment), or null. Read from the thread it is in, it is the thread's first post, \"…\" when levels are skipped, then the post it answers, one per line as \"author: text\". It explains the post; it is not the post's words","type":"string"}},"required":["ref","source","url","posted_at","excerpt","replying_to"]}}},"required":["term","slug","url","locked","kind","status","summary","clean_summary","variants","categories","trajectory","relevance","first_seen","peak","wikipedia_views","updated","confidence","senses","parents","origin","sources"]}}},"required":["locked","message","terms"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/v1/today":{"get":{"operationId":"today","summary":"Today's free entries","parameters":[{"name":"limit","in":"query","required":false,"description":"1–10, the default","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"next_cursor from the previous page","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"day":{"type":"string"},"terms":{"type":"array","items":{"type":"object","properties":{"term":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","description":"The entry on the website"},"locked":{"type":"boolean","enum":[false]},"kind":{"type":"string","enum":["slang","meme","reference","catchphrase","acronym"]},"status":{"type":"string","enum":["published","draft"]},"summary":{"type":"string"},"clean_summary":{"nullable":true,"description":"The summary as you would put it to a class, when `summary` is explicit","type":"string"},"variants":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}},"trajectory":{"type":"string","description":"Measured from counts: rising, peaking, steady, fading, dormant or unknown"},"relevance":{"type":"number","description":"0–100, measured from how much the term is used now"},"first_seen":{"nullable":true,"type":"string"},"peak":{"nullable":true,"type":"string"},"wikipedia_views":{"nullable":true,"description":"How often people looked the term up on Wikipedia, by month, when an article about it exists. Lookups, not uses","type":"object","properties":{"article":{"type":"string"},"url":{"type":"string"},"since":{"type":"string","description":"When the article was written; no month before it is counted"},"monthly":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM"},"views":{"type":"number"}},"required":["month","views"]}}},"required":["article","url","since","monthly"]},"updated":{"type":"string"},"confidence":{"type":"string","enum":["low","medium","high"]},"senses":{"type":"array","items":{"type":"object","properties":{"meaning":{"type":"string"},"clean":{"nullable":true,"description":"The meaning as you would put it to a class, when `meaning` is explicit","type":"string"},"usage":{"type":"string"},"fine_with":{"nullable":true,"description":"The widest company it lands fine with, judged by the people who use it: anyone, strangers, friends or adults, or nobody for a slur or dogwhistle. Null when not yet rated","type":"object","properties":{"level":{"type":"string","enum":["anyone","strangers","friends","adults","nobody"]},"note":{"type":"string","description":"Where it would land badly"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["level","note","sources"]},"tone":{"nullable":true,"description":"The current tone (the newest open register period)","type":"string","enum":["affectionate","playful","neutral","ironic","derisive","hostile","slur"]},"used_by":{"nullable":true,"type":"string"},"register":{"type":"array","items":{"type":"object","properties":{"since":{"type":"string"},"until":{"nullable":true,"type":"string"},"where":{"type":"string"},"tone":{"type":"string","enum":["affectionate","playful","neutral","ironic","derisive","hostile","slur"]},"note":{"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["since","until","where","tone","note","sources"]}},"examples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Quoted word for word from a real post"},"source":{"type":"string"},"url":{"nullable":true,"type":"string"},"posted_at":{"nullable":true,"type":"string"},"tags":{"type":"array","items":{"type":"string"},"description":"The setting the post shows"},"replying_to":{"nullable":true,"description":"What the post replies to (a caption, the post above a comment), or null. Read from the thread it is in, it is the thread's first post, \"…\" when levels are skipped, then the post it answers, one per line as \"author: text\". It explains the post; it is not the post's words","type":"string"}},"required":["text","source","url","posted_at","tags","replying_to"]}},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["meaning","clean","usage","fine_with","tone","used_by","register","examples","sources"]}},"parents":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"relation":{"type":"string","enum":["references","remixes","derived_from","blend_of","misspelling_of","response_to"]},"note":{"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["label","relation","note","sources"]}},"origin":{"nullable":true,"type":"object","properties":{"note":{"type":"string"},"date":{"nullable":true,"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["note","date","sources"]},"sources":{"type":"array","items":{"type":"object","properties":{"ref":{"type":"string"},"source":{"type":"string"},"url":{"nullable":true,"type":"string"},"posted_at":{"nullable":true,"type":"string"},"excerpt":{"type":"string"},"replying_to":{"nullable":true,"description":"What the post replies to (a caption, the post above a comment), or null. Read from the thread it is in, it is the thread's first post, \"…\" when levels are skipped, then the post it answers, one per line as \"author: text\". It explains the post; it is not the post's words","type":"string"}},"required":["ref","source","url","posted_at","excerpt","replying_to"]}}},"required":["term","slug","url","locked","kind","status","summary","clean_summary","variants","categories","trajectory","relevance","first_seen","peak","wikipedia_views","updated","confidence","senses","parents","origin","sources"]}},"next_cursor":{"nullable":true,"type":"string"}},"required":["day","terms","next_cursor"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/v1/categories":{"get":{"operationId":"categories","summary":"Every category in use","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"categories":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"terms":{"type":"number"}},"required":["name","terms"]}}},"required":["categories"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/v1/tags":{"get":{"operationId":"tags","summary":"Every example tag in use","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"examples":{"type":"number"}},"required":["name","examples"]}}},"required":["tags"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/v1/contributions":{"post":{"operationId":"contribute","summary":"Send in public posts that use a term (account required)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"term":{"type":"string","maxLength":100,"description":"The term as the posts spell it"},"examples":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"description":"Link to the public post or comment itself"},"quote":{"type":"string","maxLength":500,"description":"A passage of the post that uses the term, copied exactly"},"note":{"description":"Where you saw it and how it was used there","type":"string","maxLength":300}},"required":["url","quote"]}},"meaning":{"description":"What you think it means. Only the editor sees this.","type":"string","maxLength":500},"model":{"description":"Your model name, if an AI is sending this","type":"string","maxLength":80}},"required":["term","examples"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"known":{"type":"boolean"},"outcomes":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"string","enum":["refused","checked","scouting","rejected"]},"message":{"type":"string"},"id":{"nullable":true,"type":"number"}},"required":["url","status","message","id"]}}},"required":["known","outcomes"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/v1/votes":{"post":{"operationId":"vote","summary":"Vote on an entry, a sense or a source (account required)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"term":{"type":"string","description":"The term, by slug or any spelling"},"target":{"default":"term","type":"string","enum":["term","sense","source"]},"sense":{"description":"For target \"sense\": its index in senses","type":"integer","minimum":0,"maximum":9007199254740991},"source":{"description":"For target \"source\": the source ref, like \"p12\"","type":"string"},"value":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[-1]}]},"reason":{"type":"string","maxLength":300}},"required":["term","value"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"flagged":{"type":"boolean"},"redraft":{"type":"boolean"}},"required":["flagged","redraft"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/v1/feedback":{"post":{"operationId":"feedback","summary":"Report a problem, or how a term landed (account required)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"term":{"description":"The term it is about, if any","type":"string"},"kind":{"type":"string","enum":["wrong","outdated","offensive","missing","outcome","other"],"description":"\"outcome\" reports how a term landed when your AI used it"},"outcome":{"description":"For kind \"outcome\"","type":"string","enum":["landed","fell_flat","offended"]},"text":{"type":"string","maxLength":2000}},"required":["kind"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"redraft":{"type":"boolean"}},"required":["id","redraft"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/v1/saved":{"get":{"operationId":"listSaved","summary":"Your saved slang (account required). format=markdown returns it as one Markdown file","parameters":[{"name":"q","in":"query","required":false,"description":"Words to find in a saved term, its meanings or its note","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"saved (newest first, default), alpha or relevance","schema":{"type":"string"}},{"name":"format","in":"query","required":false,"description":"markdown for text/markdown instead of JSON","schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"description":"Comma-separated kinds","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Comma-separated categories","schema":{"type":"string"}},{"name":"tone","in":"query","required":false,"description":"Comma-separated current tones","schema":{"type":"string"}},{"name":"trajectory","in":"query","required":false,"description":"Comma-separated trajectories","schema":{"type":"string"}},{"name":"tag","in":"query","required":false,"description":"Comma-separated example tags","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"saved":{"type":"array","items":{"type":"object","properties":{"term":{"type":"string"},"slug":{"type":"string"},"note":{"nullable":true,"type":"string"},"saved_at":{"type":"string"},"entry":{"nullable":true,"description":"The entry as it stands now, or null when it has left the dictionary","type":"object","properties":{"term":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","description":"The entry on the website"},"locked":{"type":"boolean","enum":[false]},"kind":{"type":"string","enum":["slang","meme","reference","catchphrase","acronym"]},"status":{"type":"string","enum":["published","draft"]},"summary":{"type":"string"},"clean_summary":{"nullable":true,"description":"The summary as you would put it to a class, when `summary` is explicit","type":"string"},"variants":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}},"trajectory":{"type":"string","description":"Measured from counts: rising, peaking, steady, fading, dormant or unknown"},"relevance":{"type":"number","description":"0–100, measured from how much the term is used now"},"first_seen":{"nullable":true,"type":"string"},"peak":{"nullable":true,"type":"string"},"wikipedia_views":{"nullable":true,"description":"How often people looked the term up on Wikipedia, by month, when an article about it exists. Lookups, not uses","type":"object","properties":{"article":{"type":"string"},"url":{"type":"string"},"since":{"type":"string","description":"When the article was written; no month before it is counted"},"monthly":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","description":"YYYY-MM"},"views":{"type":"number"}},"required":["month","views"]}}},"required":["article","url","since","monthly"]},"updated":{"type":"string"},"confidence":{"type":"string","enum":["low","medium","high"]},"senses":{"type":"array","items":{"type":"object","properties":{"meaning":{"type":"string"},"clean":{"nullable":true,"description":"The meaning as you would put it to a class, when `meaning` is explicit","type":"string"},"usage":{"type":"string"},"fine_with":{"nullable":true,"description":"The widest company it lands fine with, judged by the people who use it: anyone, strangers, friends or adults, or nobody for a slur or dogwhistle. Null when not yet rated","type":"object","properties":{"level":{"type":"string","enum":["anyone","strangers","friends","adults","nobody"]},"note":{"type":"string","description":"Where it would land badly"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["level","note","sources"]},"tone":{"nullable":true,"description":"The current tone (the newest open register period)","type":"string","enum":["affectionate","playful","neutral","ironic","derisive","hostile","slur"]},"used_by":{"nullable":true,"type":"string"},"register":{"type":"array","items":{"type":"object","properties":{"since":{"type":"string"},"until":{"nullable":true,"type":"string"},"where":{"type":"string"},"tone":{"type":"string","enum":["affectionate","playful","neutral","ironic","derisive","hostile","slur"]},"note":{"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["since","until","where","tone","note","sources"]}},"examples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Quoted word for word from a real post"},"source":{"type":"string"},"url":{"nullable":true,"type":"string"},"posted_at":{"nullable":true,"type":"string"},"tags":{"type":"array","items":{"type":"string"},"description":"The setting the post shows"},"replying_to":{"nullable":true,"description":"What the post replies to (a caption, the post above a comment), or null. Read from the thread it is in, it is the thread's first post, \"…\" when levels are skipped, then the post it answers, one per line as \"author: text\". It explains the post; it is not the post's words","type":"string"}},"required":["text","source","url","posted_at","tags","replying_to"]}},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["meaning","clean","usage","fine_with","tone","used_by","register","examples","sources"]}},"parents":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"relation":{"type":"string","enum":["references","remixes","derived_from","blend_of","misspelling_of","response_to"]},"note":{"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["label","relation","note","sources"]}},"origin":{"nullable":true,"type":"object","properties":{"note":{"type":"string"},"date":{"nullable":true,"type":"string"},"sources":{"type":"array","items":{"type":"string"},"description":"Source refs like \"p12\", each one of the entry's sources"}},"required":["note","date","sources"]},"sources":{"type":"array","items":{"type":"object","properties":{"ref":{"type":"string"},"source":{"type":"string"},"url":{"nullable":true,"type":"string"},"posted_at":{"nullable":true,"type":"string"},"excerpt":{"type":"string"},"replying_to":{"nullable":true,"description":"What the post replies to (a caption, the post above a comment), or null. Read from the thread it is in, it is the thread's first post, \"…\" when levels are skipped, then the post it answers, one per line as \"author: text\". It explains the post; it is not the post's words","type":"string"}},"required":["ref","source","url","posted_at","excerpt","replying_to"]}}},"required":["term","slug","url","locked","kind","status","summary","clean_summary","variants","categories","trajectory","relevance","first_seen","peak","wikipedia_views","updated","confidence","senses","parents","origin","sources"]},"warnings":{"type":"array","items":{"type":"string"},"description":"What has changed that matters before using it: faded, turned harsh, still a draft, gone"}},"required":["term","slug","note","saved_at","entry","warnings"]}},"count":{"type":"number"}},"required":["saved","count"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}},"post":{"operationId":"save","summary":"Save a term, or change its note (account required). Changes nothing in the dictionary","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"term":{"type":"string","description":"The term, in any spelling the dictionary knows"},"note":{"description":"When or how to use it, in your words. Left out keeps the note; empty or null clears it","nullable":true,"type":"string","maxLength":300}},"required":["term"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"term":{"type":"string"},"slug":{"type":"string"},"added":{"type":"boolean"},"count":{"type":"number"}},"required":["term","slug","added","count"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/v1/saved/{term}":{"delete":{"operationId":"forget","summary":"Remove a term from your saved slang (account required)","parameters":[{"name":"term","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"removed":{"type":"boolean"}},"required":["removed"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/v1/me":{"get":{"operationId":"me","summary":"The account behind the key, its standing and today's usage","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"account":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"email":{"nullable":true,"type":"string"},"plan":{"type":"string"},"status":{"type":"string"},"status_reason":{"nullable":true,"type":"string"}},"required":["id","name","email","plan","status","status_reason"]},"standing":{"type":"object","properties":{"strikes":{"type":"number"},"recent_examples":{"type":"number"},"recent_bad":{"type":"number"},"warn_at":{"type":"number"},"ban_at":{"type":"number"}},"required":["strikes","recent_examples","recent_bad","warn_at","ban_at"]},"usage_today":{"type":"object","additionalProperties":{"type":"number"}}},"required":["account","standing","usage_today"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}}}}