Graphon API

Upload an object

Writes the request body as a new version of one object, up to the request limit, and returns the version. An existing key gets a new version, and the old one stays recoverable. Send If-None-Match: * to create only. x-amz-meta-<key> headers set the metadata. For a larger file, presign a multipart upload. Role: editor or higher.

PUT/v1/workspaces/{workspaceId}/buckets/{bucketId}/objects/{keyToken}/content

Authentication

Send your Graphon API key with every request. The value is the whole API key that Graphon showed when you created it. See Authentication.

Authorization: Bearer <GRAPHON_API_KEY>

Path parameters

workspaceIdstring

The workspace id.

bucketIdstring

The bucket id.

keyTokenstring

The object key, base64url-encoded without padding.

Headers

content-lengthstring (optional)

Required. The size of the body in bytes.

content-typestring (optional)

The object content type. Leave it out to use the type for the key's extension.

if-none-matchstring (optional)

Send * to create only. The PUT fails with 412 when the key exists.

if-matchstring (optional)

Replace only the live version with this etag. Else the PUT fails with 412.

x-amz-checksum-sha256string (optional)

The base64 SHA-256 of the body. Graphon Storage rejects other bytes.

cache-controlstring (optional)

Stored with the object and sent back on a read.

content-dispositionstring (optional)

Stored with the object and sent back on a read.

content-encodingstring (optional)

Stored with the object and sent back on a read.

content-languagestring (optional)

Stored with the object and sent back on a read.

Was this page helpful?
View as Markdown