Settings

Update a storage bucket

PATCH/settings/storage/{id}/

manage Delete and money: deletes, credits, servers or panel settings. Scopes

An empty secret_key keeps the stored one. Panel operators only.

Path parameters

  • idstring (uuid)required

    A UUID string identifying this Storage Connection.

Body

  • namestring

    How this bucket is named wherever it can be picked, e.g. "Movies (Wasabi)".

  • endpointstring

    e.g. https://s3.eu-west-1.amazonaws.com, or your MinIO / Wasabi / R2 / Backblaze endpoint.

  • bucketstring
  • regionstring

    Part of the request signature. MinIO accepts us-east-1 unless configured otherwise.

  • access_keystring
  • secret_keystring

Response

200 OK

  • idstring (uuid)requiredread-only
  • namestringrequired

    How this bucket is named wherever it can be picked, e.g. "Movies (Wasabi)".

  • endpointstringrequired

    e.g. https://s3.eu-west-1.amazonaws.com, or your MinIO / Wasabi / R2 / Backblaze endpoint.

  • bucketstringrequired
  • regionstring

    Part of the request signature. MinIO accepts us-east-1 unless configured otherwise.

  • access_keystringrequired
  • has_secretbooleanrequiredread-only
  • used_bystring[]requiredread-only
  • last_checked_atstring (date-time)requiredread-onlycan be null
  • last_check_okbooleanrequiredread-onlycan be null
  • last_check_messagestringrequiredread-only
  • created_atstring (date-time)requiredread-only
  • updated_atstring (date-time)requiredread-only

Errors

  • 400 Something sent is not valid. Each field that is wrong is named with what is wrong.
  • 401 No credential, or one that is wrong, expired or revoked.
  • 403 The account, or the key's or app's scopes, may not do this.
  • 404 Nothing with this id, or nothing the account can see.
  • 429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means