New Shield Mode endpoints and EventSub subscription type are now in open beta

gmt2001 · December 3, 2022, 5:15am

The documentation for Update Shield Mode Status is incorrect

Documented PUT body

{"data":{"is_active":false}}

Correct PUT body

{"is_active":false}

Tested and confirmed

iProdigy additionally noticed that the documentation indicates a header

Client-Type: application/json

which should be changed to

Content-Type: application/json

github.com/twitchdev/issues

Update Shield Mode Status - Incorrect PUT Body and Headers in Documentation

opened 05:33AM - 03 Dec 22 UTC

closed 06:18PM - 09 Aug 23 UTC

gmt2001

product: docs done

**Brief description** The PUT body and headers in the documentation for [Update… Shield Mode Status](https://dev.twitch.tv/docs/api/reference/#update-shield-mode-status) is incorrect **Incorrect documentation** ``` curl -X PUT 'https://api.twitch.tv/helix/moderation/shield_mode?broadcaster_id=12345&moderator_id=98765' \ -H 'Authorization: Bearer kpvy3cjboypmiacwr0c19hotn5s' \ -H 'Client-Id: hof5gwx0su6owfn0yan9c87zr6t' \ -H 'Client-Type: application/json' \ -d '{"data":{"is_active":false}}' ``` **Expected documentation** ``` curl -X PUT 'https://api.twitch.tv/helix/moderation/shield_mode?broadcaster_id=12345&moderator_id=98765' \ -H 'Authorization: Bearer kpvy3cjboypmiacwr0c19hotn5s' \ -H 'Client-Id: hof5gwx0su6owfn0yan9c87zr6t' \ -H 'Content-Type: application/json' \ -d '{"is_active":false}' ``` **Screenshots** ![image](https://user-images.githubusercontent.com/3355471/205425867-dda07f79-36ab-4419-8804-a388722bb75a.png) **Additional Observation** The endpoint will return _200 OK_ and the body showing the current state (before the attempted state change) of Shield Mode if using the incorrect body defined in the documentation. I would expect this to return _400 Bad Request_