Organisations

Write a test file

Writes plotwork-test.svg at the top of the destination and answers its link, or why it failed.

POST/orgs/{org}/storage/{id}/test

TL;DR

Question	Answer
What does it do?	Write a test file.
What does it take?	`org`, `id` in the path.
What does it return?	Status 200 with a body of type `StorageTest`.
What can go wrong?	`401` not signed in; `403` not the owner or an admin (orgs.forbidden), the plan does not include it (plan.storage_not_included), or the origin may not make changes; `404` no such organisation or destination, or the caller is not a member; `429` too many requests; `503` sending to your storage is not available on this server (storage.unavailable). Every failure uses the one error envelope.

Writes plotwork-test.svg at the top of the destination and answers its link, or why it failed.

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

Status	Meaning	Body
200	How the test went.	`StorageTest`
401	Not signed in.	`ErrorResponse`
403	Not the owner or an admin (orgs.forbidden), the plan does not include it (plan.storage_not_included), or the origin may not make changes.	`ErrorResponse`
404	No such organisation or destination, or the caller is not a member.	`ErrorResponse`
429	Too many requests.	`ErrorResponse`
503	Sending to your storage is not available on this server (storage.unavailable).	`ErrorResponse`

A 200 answer has the type StorageTest.

Field	Type	Required	Description
`ok`	`boolean`	yes
`error`	`string \| null`	yes
`link`	`string \| null`	yes	Where to see the sample file, in Drive or the cloud console.

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