Resource browsing API: Pick Folders for Grant Scopes - OneCLI

Resource scoping limits a connection grant to specific folders, so an agent sees only part of an account. These endpoints let you browse a connected account’s folders to pick those scopes. Pass the folder ids you choose into a grant through the Grants endpoints. For how scoped grants work, see Agent access.

Endpoints

Endpoint	Method and path	What it does
Browse a Dropbox connection’s folders	`GET /apps/dropbox/folders`	Browse the subfolders of a path on a connected Dropbox account so you can pick folders for a grant’s resource scope.
Browse a Google Drive connection’s folders	`GET /apps/google-drive/folders`	Browse the subfolders of a Google Drive folder, or My Drive and shared drives at the top level, to pick folders for a grant’s scope.
Resolve Google Drive folder names	`GET /apps/google-drive/folder-names`	Resolve saved Google Drive folder ids to readable names for display.

Next steps

API overview: base URLs, authentication, and pagination
Errors: status codes and the error format
Editions: which endpoints each edition serves