Can't create stream as owner's bot: "Insufficient permission"

There appears to be a mismatch between what the documentation at https://zulip.com/help/bots-and-integrations#bot-type says about Generic bots (“Anything the bot creator can do”) and the actual effective permissions:

• Stream permissions > Who can create public streams: Admins and moderators
• Bot owner: Me (Role: Owner)
• Bot type: Generic bot
• Request URL: https://project-stream-bot%40iter-square.zulipchat.com:[e-mail]/api/v1/users/me/subscriptions?announce=true&authorization_errors_fatal=true&history_public_to_subscribers=true&message_retention_days=%22realm_default%22&principals=%5B450752%5D&stream_post_policy=1&subscriptions=%5B%7B%22name%22%3A%22project%2Fiteration-square-automation%22%2C%22description%22%3A%22Automation+endpoints+for+my+Zulip+organisation.%22%7D%5D
• Respone from Zulip: {"result":"error","msg":"Insufficient permission","code":"BAD_REQUEST"} (400 Bad Request)

It works fine if I impersonate myself by replacing the email and token in that URL instead.

[timabbott]

I pushed a change to correct the inaccurate documentation here. I expect @alya to open an issue in a couple days for adding web UI for displaying and changing bots’ roles; that’ll benefit from a fresh issue.

Thanks again for the report @Tamschi!

[alya]

Filed #21105.