Sign in
worker

Upload an object

Uploads an object to the Sia network.

put/worker/object/{key}

Path parameters

keystring required
Example:folder/file

The key of the file to upload

Query parameters

bucketstring required

The name of the bucket.

Example:default

The name of the bucket the object belongs to

minshardsinteger

The number of data shards a piece of an object gets erasure-coded into

Used to override the minimum number of shards the object should be split into.

totalshardsinteger

The number of total data shards a piece of an object gets erasure-coded into

Used to override the total number of shards the object should be split into.

mimetypestring

The MIME type of the object

Example:text/plain

The MIME type of the object

Response

Successfully uploaded object

Changes

Changed in 4 of the 50 revisions of this API.822

  • c38282599c5a42See the full diff
    • ▲

      for the query request parameter minshards, default value 10 was added

      request-parameter-default-value-added

    • ▲

      for the query request parameter totalshards, default value 30 was added

      request-parameter-default-value-added

    • ▲

      for the query request parameter minshards, the type/format was changed from integer/uint32 to integer/uint8

      request-parameter-type-changed

    • ▲

      for the query request parameter totalshards, the type/format was changed from integer/uint32 to integer/uint8

      request-parameter-type-changed

    • ●

      for the query request parameter minshards, the min was set to 1.00

      request-parameter-min-set

    • ●

      for the query request parameter totalshards, the min was set to 2.00

      request-parameter-min-set

  • 922f156353c931See the full diff
    • ▲

      removed the media type text/plain for the response with the status 400

      response-media-type-removed

    • ▲

      removed the media type text/plain for the response with the status 404

      response-media-type-removed

    • ▲

      removed the media type text/plain for the response with the status 503

      response-media-type-removed

    • ○

      api tag worker added

      api-tag-added

  • 2700783521b01See the full diff
    • ○

      endpoint added

      endpoint-added

  • f062c35d8f471See the full diff
    • ▲

      api removed without deprecation

      api-removed-without-deprecation

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