New API scopes documentation

[Pokeras]

They are listed there, not documented with examples.