Sign in
bus

Store object

Stores or updates an object.

put/bus/object/{key}

Path parameters

keystring required
Example:folder/file

The key of the object

Request body

bucketstring

The name of the bucket.

eTagstring

The ETag of the object

mimeTypestring

The MIME type of the object

metadataObjectUserMetadata

User-defined metadata about an object provided through X-Sia-Meta- headers

Example request

{
  "bucket": "default",
  "object": {
    "bucket": "default",
    "etag": "W/\"33a64df551425fcc55e4d42a148795d9f25f89d4\""
  }
}

Response

Successfully stored object

Changes

Changed in 5 of the 50 revisions of this API.46

  • c38282599c5a22See the full diff
    • ▲

      added RedundancySettingsMinShards subschema #2 to the object/allOf[subschema #3]/slabs/items/slab/minShards request property allOf list

      request-property-all-of-added

    • ▲

      the object/allOf[subschema #3]/slabs/items/slab/minShards request property type/format changed from integer/uint8 to /

      request-property-type-changed

    • ○

      removed the pattern .* from the path request parameter key

      request-parameter-pattern-removed

    • ○

      for the path request parameter key, the type/format was generalized from string/ to /

      request-parameter-type-generalized

  • 922f156353c93See the full diff
    • ○

      api tag bus added

      api-tag-added

    • ○

      added the non-success response with the status 400

      response-non-success-status-added

    • ○

      added the non-success response with the status 500

      response-non-success-status-added

  • 6bb182f7a7d21See the full diff
    • ▲

      added the pattern .* to the path request parameter key

      request-parameter-pattern-added

  • d5dec74bd45a1See the full diff
    • ○

      endpoint added

      endpoint-added

  • f062c35d8f471See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 99 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog