curl --request POST \ --url https://api.bodyguard.ai/feedback/v1/text \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "analyzeRequest": { "channelId": "<your-channel-id>", "text": "Einstein is an asshole", "publishedAt": "2026-04-23T10:30:00.000Z", "reference": "comment-12346" }, "classificationsToRemove": [ "INSULT" ], "notes": "Quoting a well-known joke, not an insult directed at anyone.", "confidence": "HIGH"}'
{ "id": "018f3b04-9c11-7a52-8e0d-3b7c9a1f4e62"}
Text analysis feedback
Sends feedback on a classification returned by POST /analyze/v1/text that you judge incorrect for a given message, with the classifications you would have expected instead.
Send the exact analyze request body you initially submitted in analyzeRequest. This will allow Bodyguard to replicate the analysis you referenced in your feedback and potentially enhance it based on your context.
Before diving in, we recommend reading the text taxonomy to understand the classifications you can add or remove.
POST
/
feedback
/
v1
/
text
curl --request POST \ --url https://api.bodyguard.ai/feedback/v1/text \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "analyzeRequest": { "channelId": "<your-channel-id>", "text": "Einstein is an asshole", "publishedAt": "2026-04-23T10:30:00.000Z", "reference": "comment-12346" }, "classificationsToRemove": [ "INSULT" ], "notes": "Quoting a well-known joke, not an insult directed at anyone.", "confidence": "HIGH"}'
{ "id": "018f3b04-9c11-7a52-8e0d-3b7c9a1f4e62"}
Authorizations
Authorization
string
header
default:ApiKey <your-api-key>
required
API key authentication. Provide your key in the Authorization
header with the ApiKey scheme:
Authorization: ApiKey <your-api-key>
Body
application/json
Feedback on a text analysis. Provide at least one of classificationsToAdd, classificationsToRemove, or notes — a request with none of the three is considered invalid.
analyzeRequest
object
required
The analyze request body you originally sent to POST /analyze/v1/text. Send it unchanged so Bodyguard can identify the exact analysis your feedback refers to. It already carries the channel the message belongs to, and your own reference for the message when you sent one.
Show child attributes
classificationsToRemove
string[]
Classifications Bodyguard returned that you judge do not apply to this content. See the text taxonomy for the full list.
Example:
["INSULT"]
classificationsToAdd
string[]
Classifications you judge apply to this content but that Bodyguard did not return. See the text taxonomy for the full list.
Example:
["CRITICISM"]
notes
string
Notes will help explain why you judge the content differently from the classification received. They help Bodyguard's moderation team understand your feedback and can lead to a quicker edit. Note-only feedback is valid and will be reviewed by our team.
confidence
enum<string>
Confidence scores reflect a feedback source's reliability based on its moderation expertise, helping Bodyguard prioritize feedback. Scores range from LOW to VERY_HIGH: end-user reports may be LOW, while Trust & Safety feedback may be VERY_HIGH. This field is optional — omit it if reliability can't be assessed.
Available options:
LOW,
MEDIUM,
HIGH,
VERY_HIGH
Response
200 - application/json
Feedback recorded.
id
string<uuid>
required
Bodyguard's identifier for this feedback.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bodyguard","description":"Bodyguard Product Documentation","colors":{"primary":"#003c7c","light":"#24bfe2","dark":"#00356b"},"logo":{"light":"https://mintcdn.com/bodyguardai/CXXaMNDOCYmwXYkN/images/logo-light.svg?fit=max\u0026auto=format\u0026n=CXXaMNDOCYmwXYkN\u0026q=85\u0026s=53fbcc63f9cb65a2b24e72faf85fcbc6","dark":"https://mintcdn.com/bodyguardai/CXXaMNDOCYmwXYkN/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=CXXaMNDOCYmwXYkN\u0026q=85\u0026s=6493bb8bbf5fcf8d13db821f0694db4f","href":"/en/documentation/introduction"},"favicon":"https://mintcdn.com/bodyguardai/bT4NridthvvIprMF/images/favicon.svg?fit=max\u0026auto=format\u0026n=bT4NridthvvIprMF\u0026q=85\u0026s=2b8d9703c3fcc88f4fb43893eeee43db","appearance":{"default":"light"},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://app.bodyguard.ai"}},"footer":{"socials":{"x":"https://twitter.com/Bodyguard_intl","facebook":"https://www.facebook.com/Bodyguard.intl","instagram":"https://www.instagram.com/bodyguard.ai","linkedin":"https://www.linkedin.com/company/bodyguard-intl"},"links":[{"header":"Resources","items":[{"label":"Status page","href":"https://status.bodyguard.ai"}]}]},"seo":{"indexing":"all"},"fonts":{"family":"Inter"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","latex":false},"navigation":{"languages":[{"language":"en","href":"en/documentation/introduction"},{"language":"fr","href":"fr/documentation/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bodyguardai","hasAudioNarration":false,"actualSubdomain":"bodyguardai","customDomains":["docs.bodyguard.ai"],"gitSource":{"type":"github","owner":"bodyguard-ai","repo":"documentation","deployBranch":"main","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af70386e0d078336552c1f4","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"en","tag":"API Reference","count":8},{"language":"fr","tag":"Référence API","count":8},{"language":"en","tag":"Documentation","count":6},{"language":"fr","tag":"Documentation","count":6},{"language":"default","tag":"API Reference","count":6},{"language":"default","tag":"Reference","count":6},{"language":"en","tag":"Webhooks","count":5},{"language":"fr","tag":"Webhooks","count":5},{"language":"en","tag":"API Documentation","count":3},{"language":"en","tag":"Taxonomy","count":3},{"language":"fr","tag":"Documentation API","count":3},{"language":"fr","tag":"Taxonomie","count":3},{"language":"default","tag":"Analyze","count":3},{"language":"default","tag":"Feedback","count":3},{"language":"en","tag":"How-to","count":2},{"language":"fr","tag":"Guides pratiques","count":2},{"language":"en","tag":"Reference","count":1},{"language":"en","tag":"Getting started","count":1},{"language":"fr","tag":"Référence","count":1},{"language":"fr","tag":"Pour commencer","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/feedback/text-analysis-feedback","slug":"/api-reference/feedback/text-analysis-feedback","pageMetadata":{"title":"Text analysis feedback","description":"Sends [feedback](/en/api-reference/concepts#feedback) on a classification returned by [`POST /analyze/v1/text`](/api-reference/analyze/analyze-a-text-message) that you judge incorrect for a given message, with the classifications you would have expected instead.\n\nSend the exact analyze request body you initially submitted in `analyzeRequest`. This will allow Bodyguard to replicate the analysis you referenced in your feedback and potentially enhance it based on your context.\n\nBefore diving in, we recommend reading the [text taxonomy](/en/documentation/taxonomy/text-classifications) to understand the classifications you can add or remove.\n","deprecated":null,"version":null,"openapi":"/openapi/feedback.openapi.yaml post /feedback/v1/text","href":"/api-reference/feedback/text-analysis-feedback","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Sends \", _jsx(_components.a, {\n href: \"/en/api-reference/concepts#feedback\",\n children: \"feedback\"\n }), \" on a classification returned by \", _jsx(_components.a, {\n href: \"/api-reference/analyze/analyze-a-text-message\",\n children: _jsx(_components.code, {\n children: \"POST /analyze/v1/text\"\n })\n }), \" that you judge incorrect for a given message, with the classifications you would have expected instead.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Send the exact analyze request body you initially submitted in \", _jsx(_components.code, {\n children: \"analyzeRequest\"\n }), \". This will allow Bodyguard to replicate the analysis you referenced in your feedback and potentially enhance it based on your context.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Before diving in, we recommend reading the \", _jsx(_components.a, {\n href: \"/en/documentation/taxonomy/text-classifications\",\n children: \"text taxonomy\"\n }), \" to understand the classifications you can add or remove.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Text analysis feedback","description":"Sends [feedback](/en/api-reference/concepts#feedback) on a classification returned by [`POST /analyze/v1/text`](/api-reference/analyze/analyze-a-text-message) that you judge incorrect for a given message, with the classifications you would have expected instead.\n\nSend the exact analyze request body you initially submitted in `analyzeRequest`. This will allow Bodyguard to replicate the analysis you referenced in your feedback and potentially enhance it based on your context.\n\nBefore diving in, we recommend reading the [text taxonomy](/en/documentation/taxonomy/text-classifications) to understand the classifications you can add or remove.\n","deprecated":null,"version":null,"openapi":"/openapi/feedback.openapi.yaml post /feedback/v1/text","href":"/api-reference/feedback/text-analysis-feedback","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Feedback"],"operationId":"bodyguard.feedback.v1.CreateTextFeedback","summary":"Text analysis feedback","description":"Sends [feedback](/en/api-reference/concepts#feedback) on a classification returned by [`POST /analyze/v1/text`](/api-reference/analyze/analyze-a-text-message) that you judge incorrect for a given message, with the classifications you would have expected instead.\n\nSend the exact analyze request body you initially submitted in `analyzeRequest`. This will allow Bodyguard to replicate the analysis you referenced in your feedback and potentially enhance it based on your context.\n\nBefore diving in, we recommend reading the [text taxonomy](/en/documentation/taxonomy/text-classifications) to understand the classifications you can add or remove.\n","requestBody":"700e5ff4-4e4a-490e-b104-82dfbb0fe7ef","responses":{"200":"d13e9513-ac6f-440b-8294-2243d209ddca"},"method":"post","type":"path","servers":["b3c2fb0c-39f2-40bb-ad96-7836688dbd41"],"security":["a73143ea-8ea4-4870-8337-4d4d648b72b5"],"path":"/feedback/v1/text","baseUrlOptions":["https://api.bodyguard.ai"],"title":"Text analysis feedback","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["analyzeRequest"],"description":"Feedback on a text analysis. Provide at least one of `classificationsToAdd`, `classificationsToRemove`, or `notes` — a request with none of the three is considered invalid.","properties":{"analyzeRequest":{"type":"object","required":["channelId","text"],"properties":{"channelId":{"type":"string","format":"uuid","description":"Identifier of the [channel](/en/api-reference/concepts#channel) the text belongs to. Provided by Bodyguard.","isRequired":true,"uniqueKey":"analyzeRequest.channelId","typeLabel":"string\u003cuuid>"},"text":{"type":"string","maxLength":10000,"description":"The text content that was analyzed.","example":"I love this product!","isRequired":true,"uniqueKey":"analyzeRequest.text","typeLabel":"string"},"publishedAt":{"type":"string","format":"date-time","description":"[Publication date](/en/api-reference/concepts#publication-date-publishedat) of the message.","uniqueKey":"analyzeRequest.publishedAt","typeLabel":"string\u003cdate-time>"},"reference":{"type":"string","maxLength":256,"description":"Your own stable identifier for this piece of content.","uniqueKey":"analyzeRequest.reference","typeLabel":"string"},"permalink":{"type":"string","format":"uri","description":"A public URL pointing to the content, if available.","uniqueKey":"analyzeRequest.permalink","typeLabel":"string\u003curi>"},"language":{"type":"string","minLength":2,"maxLength":2,"description":"Language of the content as an ISO 639-1 code (e.g. `en`, `fr`). If set, the analysis is forced in this language and auto-detection is disabled. If omitted, language is auto-detected.","example":"en","uniqueKey":"analyzeRequest.language","typeLabel":"string"},"post":{"oneOf":[{"type":"object","description":"Metadata about the post the analyzed content belongs to, as sent in the original analyze request.","required":["title"],"properties":{"title":{"type":"string","maxLength":2048,"description":"Title or short description of the post. Can be omitted or left empty, in which case `reference` is required.","isRequired":true,"uniqueKey":"analyzeRequest.post.oneOf.0.title","typeLabel":"string"},"reference":{"type":"string","maxLength":256,"description":"Your own stable identifier for this post. Required if `title` is omitted or empty.","uniqueKey":"analyzeRequest.post.oneOf.0.reference","typeLabel":"string"},"publishedAt":{"type":"string","format":"date-time","description":"[Publication date](/en/api-reference/concepts#publication-date-publishedat) of the post.","uniqueKey":"analyzeRequest.post.oneOf.0.publishedAt","typeLabel":"string\u003cdate-time>"},"permalink":{"type":"string","format":"uri","description":"Public URL of the post.","uniqueKey":"analyzeRequest.post.oneOf.0.permalink","typeLabel":"string\u003curi>"},"countryCodes":{"type":"array","description":"Countries the post is aimed at, as uppercase ISO 3166-1 alpha-2 codes (e.g. `US`, `FR`). A post can target several countries. This information will help Bodyguard adapt its moderation rules to the cultural and linguistic context of each country. A word can be an insult in one country and a neutral adjective in another. Including the country codes offers the context necessary for more accurate content moderation.","items":{"type":"string","minLength":2,"maxLength":2,"uniqueKey":"analyzeRequest.post.oneOf.0.countryCodes.items.[INDEX]","typeLabel":"string"},"example":["US","CA"],"uniqueKey":"analyzeRequest.post.oneOf.0.countryCodes","typeLabel":"string[]"}},"uniqueKey":"analyzeRequest.post.oneOf.0","typeLabel":"object"},{"type":"object","description":"Metadata about the post the analyzed content belongs to, as sent in the original analyze request.","required":["reference"],"properties":{"reference":{"type":"string","maxLength":256,"description":"Your own stable identifier for this post. Required if `title` is omitted or empty.","isRequired":true,"uniqueKey":"analyzeRequest.post.oneOf.1.reference","typeLabel":"string"},"title":{"type":"string","maxLength":2048,"description":"Title or short description of the post. Can be omitted or left empty, in which case `reference` is required.","uniqueKey":"analyzeRequest.post.oneOf.1.title","typeLabel":"string"},"publishedAt":{"type":"string","format":"date-time","description":"[Publication date](/en/api-reference/concepts#publication-date-publishedat) of the post.","uniqueKey":"analyzeRequest.post.oneOf.1.publishedAt","typeLabel":"string\u003cdate-time>"},"permalink":{"type":"string","format":"uri","description":"Public URL of the post.","uniqueKey":"analyzeRequest.post.oneOf.1.permalink","typeLabel":"string\u003curi>"},"countryCodes":{"type":"array","description":"Countries the post is aimed at, as uppercase ISO 3166-1 alpha-2 codes (e.g. `US`, `FR`). A post can target several countries. This information will help Bodyguard adapt its moderation rules to the cultural and linguistic context of each country. A word can be an insult in one country and a neutral adjective in another. Including the country codes offers the context necessary for more accurate content moderation.","items":{"type":"string","minLength":2,"maxLength":2,"uniqueKey":"analyzeRequest.post.oneOf.1.countryCodes.items.[INDEX]","typeLabel":"string"},"example":["US","CA"],"uniqueKey":"analyzeRequest.post.oneOf.1.countryCodes","typeLabel":"string[]"}},"uniqueKey":"analyzeRequest.post.oneOf.1","typeLabel":"object"}],"uniqueKey":"analyzeRequest.post","typeLabel":"object"},"author":{"oneOf":[{"type":"object","description":"Metadata about the author of the content, as sent in the original analyze request.","required":["username"],"properties":{"username":{"type":"string","maxLength":255,"description":"Display name / username of the author. Can be omitted or left empty, in which case `reference` is required.","isRequired":true,"uniqueKey":"analyzeRequest.author.oneOf.0.username","typeLabel":"string"},"reference":{"type":"string","maxLength":256,"description":"Your own stable identifier for this author. Required if `username` is omitted or empty.","uniqueKey":"analyzeRequest.author.oneOf.0.reference","typeLabel":"string"},"permalink":{"type":"string","format":"uri","description":"Public URL of the author's profile.","uniqueKey":"analyzeRequest.author.oneOf.0.permalink","typeLabel":"string\u003curi>"},"profilePictureUrl":{"type":"string","format":"uri","description":"URL of the author's profile picture.","uniqueKey":"analyzeRequest.author.oneOf.0.profilePictureUrl","typeLabel":"string\u003curi>"},"countryCode":{"type":"string","minLength":2,"maxLength":2,"description":"Country the author is located in, as an uppercase ISO 3166-1 alpha-2 code (e.g. `US`, `FR`). This information will help Bodyguard adapt its moderation rules to the cultural and linguistic context of each country. A word can be an insult in one country and a neutral adjective in another. Including the country code offers the context necessary for more accurate content moderation.","example":"US","uniqueKey":"analyzeRequest.author.oneOf.0.countryCode","typeLabel":"string"}},"uniqueKey":"analyzeRequest.author.oneOf.0","typeLabel":"object"},{"type":"object","description":"Metadata about the author of the content, as sent in the original analyze request.","required":["reference"],"properties":{"reference":{"type":"string","maxLength":256,"description":"Your own stable identifier for this author. Required if `username` is omitted or empty.","isRequired":true,"uniqueKey":"analyzeRequest.author.oneOf.1.reference","typeLabel":"string"},"username":{"type":"string","maxLength":255,"description":"Display name / username of the author. Can be omitted or left empty, in which case `reference` is required.","uniqueKey":"analyzeRequest.author.oneOf.1.username","typeLabel":"string"},"permalink":{"type":"string","format":"uri","description":"Public URL of the author's profile.","uniqueKey":"analyzeRequest.author.oneOf.1.permalink","typeLabel":"string\u003curi>"},"profilePictureUrl":{"type":"string","format":"uri","description":"URL of the author's profile picture.","uniqueKey":"analyzeRequest.author.oneOf.1.profilePictureUrl","typeLabel":"string\u003curi>"},"countryCode":{"type":"string","minLength":2,"maxLength":2,"description":"Country the author is located in, as an uppercase ISO 3166-1 alpha-2 code (e.g. `US`, `FR`). This information will help Bodyguard adapt its moderation rules to the cultural and linguistic context of each country. A word can be an insult in one country and a neutral adjective in another. Including the country code offers the context necessary for more accurate content moderation.","example":"US","uniqueKey":"analyzeRequest.author.oneOf.1.countryCode","typeLabel":"string"}},"uniqueKey":"analyzeRequest.author.oneOf.1","typeLabel":"object"}],"uniqueKey":"analyzeRequest.author","typeLabel":"object"}},"description":"The analyze request body you originally sent to `POST /analyze/v1/text`. Send it unchanged so Bodyguard can identify the exact analysis your feedback refers to. It already carries the [channel](/en/api-reference/concepts#channel) the message belongs to, and your own `reference` for the message when you sent one.","isRequired":true,"uniqueKey":"analyzeRequest","typeLabel":"object"},"classificationsToRemove":{"type":"array","description":"Classifications Bodyguard returned that you judge do not apply to this content. See the [text taxonomy](/en/documentation/taxonomy/text-classifications) for the full list.","items":{"type":"string","uniqueKey":"classificationsToRemove.items.[INDEX]","typeLabel":"string"},"example":["INSULT"],"uniqueKey":"classificationsToRemove","typeLabel":"string[]"},"classificationsToAdd":{"type":"array","description":"Classifications you judge apply to this content but that Bodyguard did not return. See the [text taxonomy](/en/documentation/taxonomy/text-classifications) for the full list.","items":{"type":"string","uniqueKey":"classificationsToAdd.items.[INDEX]","typeLabel":"string"},"example":["CRITICISM"],"uniqueKey":"classificationsToAdd","typeLabel":"string[]"},"notes":{"type":"string","description":"Notes will help explain why you judge the content differently from the classification received. They help Bodyguard's moderation team understand your feedback and can lead to a quicker edit. Note-only feedback is valid and will be reviewed by our team.","uniqueKey":"notes","typeLabel":"string"},"confidence":{"type":"string","description":"Confidence scores reflect a feedback source's reliability based on its moderation expertise, helping Bodyguard prioritize feedback. Scores range from `LOW` to `VERY_HIGH`: end-user reports may be `LOW`, while Trust \u0026 Safety feedback may be `VERY_HIGH`. This field is optional — omit it if reliability can't be assessed.","enum":["LOW","MEDIUM","HIGH","VERY_HIGH"],"uniqueKey":"confidence","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"removeClassification":{"title":"removeClassification","summary":"Remove a classification that does not apply","value":{"analyzeRequest":{"channelId":"\u003cyour-channel-id>","text":"Einstein is an asshole","publishedAt":"2026-04-23T10:30:00.000Z","reference":"comment-12346"},"classificationsToRemove":["INSULT"],"notes":"Quoting a well-known joke, not an insult directed at anyone.","confidence":"HIGH"}},"addAndRemove":{"title":"addAndRemove","summary":"Replace a classification","value":{"analyzeRequest":{"channelId":"\u003cyour-channel-id>","text":"Einstein is an asshole","publishedAt":"2026-04-23T10:30:00.000Z","language":"en","reference":"comment-12346","author":{"username":"johndoe","reference":"user-987","countryCode":"US"}},"classificationsToRemove":["INSULT"],"classificationsToAdd":["CRITICISM"],"notes":"Criticism of a public figure, not a personal insult.","confidence":"MEDIUM"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"d13e9513-ac6f-440b-8294-2243d209ddca":{"description":"Feedback recorded.","content":{"application/json":{"schema":{"type":"object","required":["id"],"properties":{"id":{"type":"string","format":"uuid","description":"Bodyguard's identifier for this feedback.","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"recorded":{"title":"recorded","summary":"Feedback recorded","value":{"id":"018f3b04-9c11-7a52-8e0d-3b7c9a1f4e62"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"a73143ea-8ea4-4870-8337-4d4d648b72b5":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","x-default":"ApiKey \u003cyour-api-key>","description":"API key authentication. Provide your key in the `Authorization`\nheader with the `ApiKey` scheme:\n```\nAuthorization: ApiKey \u003cyour-api-key>\n```\n","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"b3c2fb0c-39f2-40bb-ad96-7836688dbd41":{"url":"https://api.bodyguard.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","x-default":"ApiKey \u003cyour-api-key>","description":"API key authentication. Provide your key in the `Authorization`\nheader with the `ApiKey` scheme:\n```\nAuthorization: ApiKey \u003cyour-api-key>\n```\n","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Authorization","type":"string","description":"API key authentication. Provide your key in the `Authorization`\nheader with the `ApiKey` scheme:\n```\nAuthorization: ApiKey \u003cyour-api-key>\n```\n","isRequired":true,"default":"ApiKey \u003cyour-api-key>","typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi/feedback.openapi.yaml"},"subdomain":"bodyguardai","siteName":"Bodyguard","title":"Text analysis feedback - Bodyguard","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/feedback/text-analysis-feedback","matchLevel":0},"fr":{"href":"/api-reference/feedback/text-analysis-feedback","matchLevel":0}}},"lastModified":"2026-11-02T16:42:05.071Z","originalFileLocation":"api-reference/feedback/text-analysis-feedback.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Sends feedback on a classification returned by POST /analyze/v1/text that you judge incorrect for a given message, with the classifications you would have expected instead. Send the exact analyze request body you initially submitted in analyzeRequest. This will allow Bodyguard to replicate the analysis you referenced in your feedback and potentially enhance it based on your context. Before diving in, we recommend reading the text taxonomy to understand the classifications you can add or remove.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bodyguard\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bodyguardai/E1zFw9LKjEKggkfV/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/bodyguardai/E1zFw9LKjEKggkfV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bodyguardai/E1zFw9LKjEKggkfV/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bodyguardai/E1zFw9LKjEKggkfV/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bodyguardai/E1zFw9LKjEKggkfV/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bodyguardai/E1zFw9LKjEKggkfV/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bodyguardai/E1zFw9LKjEKggkfV/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bodyguardai/E1zFw9LKjEKggkfV/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bodyguardai/E1zFw9LKjEKggkfV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Text analysis feedback - Bodyguard\">\u003cmeta data-mint-head property=\"og:description\" content=\"Sends feedback on a classification returned by POST /analyze/v1/text that you judge incorrect for a given message, with the classifications you would have expected instead. Send the exact analyze request body you initially submitted in analyzeRequest. This will allow Bodyguard to replicate the analysis you referenced in your feedback and potentially enhance it based on your context. Before diving in, we recommend reading the text taxonomy to understand the classifications you can add or remove.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bodyguard\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bodyguard.ai/api-reference/feedback/text-analysis-feedback\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bodyguardai.mintlify.site/_mintlify/api/og/v2?division=Feedback\u0026amp;title=Text+analysis+feedback\u0026amp;description=Sends+%5Bfeedback%5D%28%2Fen%2Fapi-reference%2Fconcepts%23feedback%29+on+a+classification+returned+by+%5B%60POST+%2Fanalyze%2Fv1%2Ftext%60%5D%28%2Fapi-reference%2Fanalyze%2Fanalyze-a-text-message%29+t\u0026amp;theme=3d68e2413a8292ff1be9b1e3\u0026amp;signature=702f19515f664cd41e1706cc18e851dceefe97fab8cd45bc25a44a075daafa46\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Text analysis feedback - Bodyguard\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Sends feedback on a classification returned by POST /analyze/v1/text that you judge incorrect for a given message, with the classifications you would have expected instead. Send the exact analyze request body you initially submitted in analyzeRequest. This will allow Bodyguard to replicate the analysis you referenced in your feedback and potentially enhance it based on your context. Before diving in, we recommend reading the text taxonomy to understand the classifications you can add or remove.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bodyguardai.mintlify.site/_mintlify/api/og/v2?division=Feedback\u0026amp;title=Text+analysis+feedback\u0026amp;description=Sends+%5Bfeedback%5D%28%2Fen%2Fapi-reference%2Fconcepts%23feedback%29+on+a+classification+returned+by+%5B%60POST+%2Fanalyze%2Fv1%2Ftext%60%5D%28%2Fapi-reference%2Fanalyze%2Fanalyze-a-text-message%29+t\u0026amp;theme=3d68e2413a8292ff1be9b1e3\u0026amp;signature=702f19515f664cd41e1706cc18e851dceefe97fab8cd45bc25a44a075daafa46\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/bodyguardai/E1zFw9LKjEKggkfV/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bodyguard\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#003c7c\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bodyguard.ai/api-reference/feedback/text-analysis-feedback\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/feedback/text-analysis-feedback.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bodyguard.ai/#organization\",\"name\":\"Bodyguard\",\"url\":\"https://docs.bodyguard.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bodyguardai/CXXaMNDOCYmwXYkN/images/logo-light.svg?fit=max\u0026auto=format\u0026n=CXXaMNDOCYmwXYkN\u0026q=85\u0026s=53fbcc63f9cb65a2b24e72faf85fcbc6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bodyguard.ai#website\",\"name\":\"Bodyguard\",\"url\":\"https://docs.bodyguard.ai\",\"publisher\":{\"@id\":\"https://docs.bodyguard.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bodyguard.ai/api-reference/feedback/text-analysis-feedback#webpage\",\"url\":\"https://docs.bodyguard.ai/api-reference/feedback/text-analysis-feedback\",\"name\":\"Text analysis feedback\",\"description\":\"Sends feedback on a classification returned by POST /analyze/v1/text that you judge incorrect for a given message, with the classifications you would have expected instead. Send the exact analyze request body you initially submitted in analyzeRequest. This will allow Bodyguard to replicate the analysis you referenced in your feedback and potentially enhance it based on your context. Before diving in, we recommend reading the text taxonomy to understand the classifications you can add or remove.\",\"dateModified\":\"2026-11-02T16:42:05.071Z\",\"isPartOf\":{\"@id\":\"https://docs.bodyguard.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bodyguard.ai/api-reference/feedback/text-analysis-feedback#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bodyguard.ai/api-reference/feedback/text-analysis-feedback#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference\",\"item\":\"https://docs.bodyguard.ai/api-reference/analyze/analyze-a-text-message\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Text analysis feedback\",\"item\":\"https://docs.bodyguard.ai/api-reference/feedback/text-analysis-feedback\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bodyguard.ai/api-reference/feedback/text-analysis-feedback#apireference\",\"headline\":\"Text analysis feedback\",\"name\":\"Text analysis feedback\",\"description\":\"Sends feedback on a classification returned by POST /analyze/v1/text that you judge incorrect for a given message, with the classifications you would have expected instead. Send the exact analyze request body you initially submitted in analyzeRequest. This will allow Bodyguard to replicate the analysis you referenced in your feedback and potentially enhance it based on your context. Before diving in, we recommend reading the text taxonomy to understand the classifications you can add or remove.\",\"url\":\"https://docs.bodyguard.ai/api-reference/feedback/text-analysis-feedback\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bodyguard.ai/api-reference/feedback/text-analysis-feedback#webpage\"},\"dateModified\":\"2026-11-02T16:42:05.071Z\",\"publisher\":{\"@id\":\"https://docs.bodyguard.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bodyguard.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bodyguard\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bodyguard\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/feedback/text-analysis-feedback.md","siteName":"Bodyguard","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/en/documentation/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","expanded":true,"pages":[{"title":"Introduction","href":"/en/api-reference/introduction"},{"title":"Key concepts","href":"/en/api-reference/concepts"},{"title":"Reseller Guide","href":"/en/api-reference/reseller"}]},{"group":"Webhooks","expanded":true,"pages":[{"title":"Introduction to webhooks","sidebarTitle":"Introduction","href":"/en/api-reference/webhooks/introduction"},{"title":"Webhooks quick start","sidebarTitle":"Quick start","href":"/en/api-reference/webhooks/quick-start"},{"title":"Webhook configuration","sidebarTitle":"Configuration","href":"/en/api-reference/webhooks/configuration"},{"title":"Handling webhook errors","sidebarTitle":"Handling errors","href":"/en/api-reference/webhooks/handling-errors"}]},{"group":"Reference","expanded":true,"pages":[{"group":"Analyze","expanded":true,"pages":[{"title":"Analyze a text message","deprecated":null,"version":null,"openapi":"/openapi/analyze.openapi.yaml post /analyze/v1/text","href":"/api-reference/analyze/analyze-a-text-message"},{"title":"Analyze an image","deprecated":null,"version":null,"openapi":"/openapi/analyze.openapi.yaml post /analyze/v1/image","href":"/api-reference/analyze/analyze-an-image"},{"title":"Analyze a username","description":"Analyzes a username string to detect inappropriate, offensive, or otherwise undesirable content and returns a list of classifications.\n\nBefore diving in, we recommend reading the [username taxonomy](/en/documentation/taxonomy/username-classifications) to understand the classifications returned by this endpoint.\n","deprecated":null,"version":null,"openapi":"/openapi/analyze.openapi.yaml post /analyze/v1/username","href":"/api-reference/analyze/analyze-a-username"}]},{"group":"Feedback","expanded":true,"pages":[{"title":"Text analysis feedback","deprecated":null,"version":null,"openapi":"/openapi/feedback.openapi.yaml post /feedback/v1/text","href":"/api-reference/feedback/text-analysis-feedback"},{"title":"Image analysis feedback","description":"Sends [feedback](/en/api-reference/concepts#feedback) on a classification returned by [`POST /analyze/v1/image`](/api-reference/analyze/analyze-an-image) that you judge incorrect for a given image, with the classifications you would have expected instead.\n\nSend the exact analyze request body you initially submitted in `analyzeRequest`. This will allow Bodyguard to replicate the analysis you referenced in your feedback and potentially enhance it based on your context.\n\nSend your feedback the same way you sent the image:\n\n- **By URL:** an `application/json` body, with your analyze request in `analyzeRequest`.\n- **By bytes:** a `multipart/form-data` body. Send each field of your analyze request as a form field prefixed with `analyzeRequest.`, with the image file in `analyzeRequest.imageData`. The other feedback fields are sent as form fields.\n\nBefore diving in, we recommend reading the [image taxonomy](/en/documentation/taxonomy/image-classifications) to understand the classifications you can add or remove.\n","deprecated":null,"version":null,"openapi":"/openapi/feedback.openapi.yaml post /feedback/v1/image","href":"/api-reference/feedback/image-analysis-feedback"},{"title":"Username analysis feedback","deprecated":null,"version":null,"openapi":"/openapi/feedback.openapi.yaml post /feedback/v1/username","href":"/api-reference/feedback/username-analysis-feedback"}]},{"group":"Webhooks","expanded":true,"pages":[{"title":"Webhook payloads","sidebarTitle":"Payloads","href":"/en/api-reference/reference/webhooks/payloads"}]}]}]},{"tab":"Migration guide","hidden":true,"pages":[{"title":"Migration guide","href":"/en/migration-guide/overview"}]}]},{"language":"fr","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/fr/documentation/introduction"}]},{"tab":"Référence API","groups":[{"group":"Documentation API","expanded":true,"pages":[{"title":"Introduction","href":"/fr/api-reference/introduction"},{"title":"Concepts clés","href":"/fr/api-reference/concepts"},{"title":"Guide Revendeur","href":"/fr/api-reference/reseller"}]},{"group":"Webhooks","expanded":true,"pages":[{"title":"Introduction aux webhooks","sidebarTitle":"Introduction","href":"/fr/api-reference/webhooks/introduction"},{"title":"Démarrage rapide des webhooks","sidebarTitle":"Démarrage rapide","href":"/fr/api-reference/webhooks/quick-start"},{"title":"Configuration des webhooks","sidebarTitle":"Configuration","href":"/fr/api-reference/webhooks/configuration"},{"title":"Gérer les erreurs des webhooks","sidebarTitle":"Gérer les erreurs","href":"/fr/api-reference/webhooks/handling-errors"}]},{"group":"Référence","expanded":true,"pages":[{"group":"Analyze","expanded":true,"pages":[{"title":"Analyze a text message","deprecated":null,"version":null,"openapi":"/openapi/analyze.openapi.yaml post /analyze/v1/text","href":"/api-reference/analyze/analyze-a-text-message"},{"title":"Analyze an image","deprecated":null,"version":null,"openapi":"/openapi/analyze.openapi.yaml post /analyze/v1/image","href":"/api-reference/analyze/analyze-an-image"},{"title":"Analyze a username","description":"Analyzes a username string to detect inappropriate, offensive, or otherwise undesirable content and returns a list of classifications.\n\nBefore diving in, we recommend reading the [username taxonomy](/en/documentation/taxonomy/username-classifications) to understand the classifications returned by this endpoint.\n","deprecated":null,"version":null,"openapi":"/openapi/analyze.openapi.yaml post /analyze/v1/username","href":"/api-reference/analyze/analyze-a-username"}]},{"group":"Feedback","expanded":true,"pages":[{"title":"Text analysis feedback","deprecated":null,"version":null,"openapi":"/openapi/feedback.openapi.yaml post /feedback/v1/text","href":"/api-reference/feedback/text-analysis-feedback"},{"title":"Image analysis feedback","description":"Sends [feedback](/en/api-reference/concepts#feedback) on a classification returned by [`POST /analyze/v1/image`](/api-reference/analyze/analyze-an-image) that you judge incorrect for a given image, with the classifications you would have expected instead.\n\nSend the exact analyze request body you initially submitted in `analyzeRequest`. This will allow Bodyguard to replicate the analysis you referenced in your feedback and potentially enhance it based on your context.\n\nSend your feedback the same way you sent the image:\n\n- **By URL:** an `application/json` body, with your analyze request in `analyzeRequest`.\n- **By bytes:** a `multipart/form-data` body. Send each field of your analyze request as a form field prefixed with `analyzeRequest.`, with the image file in `analyzeRequest.imageData`. The other feedback fields are sent as form fields.\n\nBefore diving in, we recommend reading the [image taxonomy](/en/documentation/taxonomy/image-classifications) to understand the classifications you can add or remove.\n","deprecated":null,"version":null,"openapi":"/openapi/feedback.openapi.yaml post /feedback/v1/image","href":"/api-reference/feedback/image-analysis-feedback"},{"title":"Username analysis feedback","deprecated":null,"version":null,"openapi":"/openapi/feedback.openapi.yaml post /feedback/v1/username","href":"/api-reference/feedback/username-analysis-feedback"}]},{"group":"Webhooks","expanded":true,"pages":[{"title":"Payloads des webhooks","sidebarTitle":"Payloads","href":"/fr/api-reference/reference/webhooks/payloads"}]}]}]},{"tab":"Guide de migration","hidden":true,"pages":[{"title":"Guide de migration","href":"/fr/migration-guide/overview"}]}]}]},"basePath":"","title":"Text analysis feedback - Bodyguard","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-jJHA3WSo.js","utils-DbZn3Mjn.js","cloneDeep-CnBnaSyy.js","_Uint8Array-CMQtTgBR.js","isObject-FP1Yky1u.js","utils-Bl2DvzOJ.js","addUniqueKeysToSchema-BwOLo9p1.js","snippetPresets-BBiPpKa-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C0px4Tml.js","isEqual-zAyttAAO.js","usePlaygroundInputsStore-Dell6dGw.js","shallow-0VKqkSqN.js","getApiPlaygroundDisplay-CP_ctPEB.js","CodeSnippet-5L35ic0s.js","CodeSnippets-DOXbNhJw.js","Page-DRLI_2Ue.js","getPastedJson-VhzT9m2P.js","icon-CD8_AtCO.js","MethodPill-DGgOMftG.js","DuplicateIcon-DZ6A_EtN.js","createIcon-DUl4oM5f.js","DynamicMarkdown-BGHukeRM.js","SectionHeading-ChrEUs8u.js","axios-vUo_bRtp.js","Markdown-Dj-na-_-.js","dist-C5gjFYHe.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-DEBW87tT.js"]}