OrganizationsOrganization settings
Test a storage connection
POST
Runs the checks a save runs — writes a file to the bucket and deletes it — and saves nothing. Refused with 400 saying why it failed.
Who may call it: An owner or security admin of the organization. API keys: no.
sessioncookie
gamma.session_token<token>The session cookie a sign-in sets. Over HTTPS its name carries the __Secure- prefix. Browsers send it on their own; other clients keep it from the sign-in response.
slug*stringThe organization's slug, as in its URL.
application/json- body
bucket*stringLength
1 <= length <= 63region*stringLength
1 <= length <= 64endpoint?||An S3-compatible endpoint, public and https; empty or absent for AWS.
prefix?stringWhere in the bucket files go; empty for the whole bucket.
Default
""accessKeyId*stringLength
1 <= lengthsecretAccessKey?stringRequired on a first connection or a new endpoint; left out or empty, the saved one is kept.
OK.
application/json- response
ok*booleanExample Request
curl -X POST 'http://localhost:3000/api/organizations/string/storage/test' \ -H 'Content-Type: application/json' \ -d '{ "bucket": "string", "region": "string", "accessKeyId": "string"}'Example Response
{ "ok": true}