internal

stage an object's metadata for the given branch

Changed on Jul 29, 2025

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

Request

Base URL
/api/v1 (relative, and the document was published on a file host, not at the API’s origin)
URL
/api/v1/repositories/{repository}/branches/{branch}/objects
Auth
- HTTP bearer
- or HTTP basic
- or API key in cookie internal_auth_session

Request body

physical_addressstring required

checksumstring required

size_bytesinteger required

mtimeinteger

Unix Epoch in seconds

metadataObjectUserMetadata

content_typestring

Object media type

forceboolean

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