Organisations

Start connecting Google Drive

Answers Google’s consent page for drive.file only, with offline access and PKCE, and sets the flow’s cookie for the callback.

POST/orgs/{org}/storage/google/start

TL;DR

Question	Answer
What does it do?	Start connecting Google Drive.
What does it take?	`org` in the path.
What does it return?	Status 200 with a body of type `StorageGoogleStart`.
What can go wrong?	`401` not signed in; `403` not the owner or an admin, or the plan does not include it (plan.storage_not_included); `404` no such organisation, or the caller is not a member; `429` too many requests; `503` this server has no Google client (storage.google_unavailable). Every failure uses the one error envelope.

Answers Google’s consent page for drive.file only, with offline access and PKCE, and sets the flow’s cookie for the callback.

Field	Type	Required	Description
`org`	`string`	yes	The organisation's id or its slug.

Status	Meaning	Body
200	Where the browser goes next.	`StorageGoogleStart`
401	Not signed in.	`ErrorResponse`
403	Not the owner or an admin, or the plan does not include it (plan.storage_not_included).	`ErrorResponse`
404	No such organisation, or the caller is not a member.	`ErrorResponse`
429	Too many requests.	`ErrorResponse`
503	This server has no Google client (storage.google_unavailable).	`ErrorResponse`

A 200 answer has the type StorageGoogleStart.

Field	Type	Required	Description
`url`	`string`	yes	Google’s consent page. The browser goes there next.

Doc	Why
API reference	Every endpoint, and the error envelope
Schemas	Every request and response type
Tool reference	The operations as callable tools