objects

Create an Object.

Create a new Object with content and metadata. The Object will be assigned a unique ID.

post/v1/objects

Request body

namestring required

The name of the Object.

content_type'unspecified' | 'text' | 'binary' | 'gzip' | 'tar' | 'tgz' required
metadataobject nullable

User defined metadata to attach to the object for organization.

Response

Object created successfully. Returns the Object with metadata.

idstring required

The unique identifier of the Object.

namestring required

The name of the Object.

statestring required

The current state of the Object.

size_bytesinteger nullable

The size of the Object content in bytes (null until uploaded).

content_type'unspecified' | 'text' | 'binary' | 'gzip' | 'tar' | 'tgz' required
create_time_msinteger required

The creation time of the Object in milliseconds since epoch.

upload_urlstring nullable

Presigned URL for uploading content to S3 (only present on create).

Changes