Add API Token information to Spectrum>BYOIP dev docs #17982
Description
Existing documentation URL(s)
https://developers.cloudflare.com/spectrum/about/byoip/
What changes are you suggesting?
One of my customers recently started to deploy BYOIPs alongside their Spectrum applications via API. They immediately started getting errors such as the below:
ERROR : Error code: 400 - {'result': None, 'success': False, 'errors': [{'code': 11019, 'message': 'The authenticated account is not authorized to use the provided edge_ips.'}], 'messages': []}
On investigating, it turned out the customer lacked IP Prefixes: Write from their API token, which is not mentioned in the dev doc they were following. After searching Google Chat, I could see a few previous occasions where other customers had run into the same issue.
The customer suggested we add a comment to the doc clarifying what permissions an API token needs, or a link to a source that already contains this detail. I'm not sure if this is mentioned elsewhere in the dev docs.
Additional information
No response