Sign in
objects

post/repositories/{repository}/branches/{branch}/objects

Query parameters

storageClassstring

Deprecated, this capability will not be supported in future releases.

forceboolean

Headers

If-None-Matchstring

Set to "*" to atomically allow the upload only if the key has no object yet. Other values are not supported.

If-Matchstring

Set to the object's ETag to atomically allow operations only if the object's current ETag matches the provided value.

Response

object metadata

pathstring required
path_type'common_prefix' | 'object' required
physical_addressstring required

The location of the object on the underlying object store. Formatted as a native URI with the object store type as scheme ("s3://...", "gs://...", etc.) Or, in the case of presign=true, will be an HTTP URL to be consumed via regular HTTP GET

physical_address_expiryinteger

If present and nonzero, physical_address is a pre-signed URL and will expire at this Unix Epoch time. This will be shorter than the pre-signed URL lifetime if an authentication token is about to expire.

This field is optional.

checksumstring required
size_bytesinteger

The number of bytes in the object. lakeFS always populates this field when returning ObjectStats. This field is optional for the client to supply, for instance on upload.

mtimeinteger required

Unix Epoch in seconds

metadataObjectUserMetadata
content_typestring

Object media type

Changes

Changed in 3 of the 52 revisions of this API.17

  • 37e11f33e0432See the full diff
    • ○

      added the new optional header request parameter If-Match

      new-optional-request-parameter

    • ○

      added the non-success response with the status 501

      response-non-success-status-added

  • 27799ffec9a52See the full diff
    • ○

      added the non-success response with the status 429

      response-non-success-status-added

    • ○

      removed the non-success response with the status 420

      response-non-success-status-removed

  • 3b10653a801313See the full diff
    • ●

      deleted the header request parameter If-Match

      request-parameter-removed

    • ○

      added the non-success response with the status 420

      response-non-success-status-added

    • ○

      removed the non-success response with the status 429

      response-non-success-status-removed

    • ○

      removed the non-success response with the status 501

      response-non-success-status-removed

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