Merge pull request #5464 from segmentio/lizkane222-patch-35

Update index.md Added Troubleshooting section Update Schema Settings …

Author: stayseesong

src/api/public-api/index.md

@@ -39,7 +39,7 @@ Within seconds, GitHub scans each commit in public repositories for Public API t
 
 Learn more about [GitHub's secret scanning program](https://docs.github.com/en/developers/overview/secret-scanning-partner-program){:target="_blank"}.
 
-### Frequently Asked Questions
+## FAQs
 #### What should I do if I see a notification that my token was exposed?
 In most cases, identifying and revoking an exposed token takes seconds. Segment recommends you check the [audit trail](/docs/segment-app/iam/audit-trail/) to ensure no unauthorized actions were taken with the token.
 
@@ -57,3 +57,30 @@ If you see a CORS error, this means you're attempting to make a request to the P
 
 #### What User Role / Workspace permissions are required to generate Public API tokens?
 Only [users that have a `Workspace Owner` role](https://segment.com/docs/segment-app/iam/roles/#global-roles) can create Public API Tokens.
+
+## Troubleshooting
+#### The `Update Schema Settings in Source` endpoint returns error for field `forwardingViolationsTo` and `forwardingBlockedEventsTo`
+When you don't have a source to forward violations or blocked events to, then exclude the fields `forwardingViolationsTo` or `forwardingBlockedEventsTo` entirely from the request and the setting will be disabled. 
+
+`PATCH`  endpoint : `https://api.segmentapis.com/sources/{sourceId}/settings`
+```
+{
+    "group": {
+      "allowTraitsOnViolations": false,
+      "allowUnplannedTraits": false,
+      "commonEventOnViolations": "ALLOW"
+    },
+    "identify": {
+      "allowTraitsOnViolations": true,
+      "allowUnplannedTraits": true,
+      "commonEventOnViolations": "Block"
+    },
+    "track": {
+      "allowEventOnViolations": false,
+      "allowPropertiesOnViolations": false,
+      "allowUnplannedEventProperties": false,
+      "allowUnplannedEvents": false,
+      "commonEventOnViolations": "OMIT_PROPERTIES"
+    }
+  }
+```