New API scopes documentation

[BarryCarlyon]

if they exist they are clearly testing them, which means they could break or be changed at any time.