Storage

S3 storage proxy endpoints

Get asset pack file

get

https://builder-api.decentraland.org/v1https://builder-api.decentraland.zone/v1

/storage/assetPacks/{filename}

Redirects to S3 URL for asset pack file

Path parameters

filenamestringRequired

Responses

301

Redirect to S3 URL

No content

get

/storage/assetPacks/{filename}

HTTPcURLJavaScriptPython

GET /v1/storage/assetPacks/{filename} HTTP/1.1
Host: builder-api.decentraland.org
Accept: */*

301

Redirect to S3 URL

No content

Get content by hash

get

https://builder-api.decentraland.org/v1https://builder-api.decentraland.zone/v1

/storage/contents/{hash}

Redirects to S3 URL for content file

Path parameters

hashstringRequired

Responses

301

Redirect to S3 URL

No content

get

/storage/contents/{hash}

HTTPcURLJavaScriptPython

GET /v1/storage/contents/{hash} HTTP/1.1
Host: builder-api.decentraland.org
Accept: */*

301

Redirect to S3 URL

No content

Get content headers

head

https://builder-api.decentraland.org/v1https://builder-api.decentraland.zone/v1

/storage/contents/{hash}

Returns headers for content file without body

Path parameters

hashstringRequired

Responses

301

Redirect to S3 URL

No content

head

/storage/contents/{hash}

HTTPcURLJavaScriptPython

HEAD /v1/storage/contents/{hash} HTTP/1.1
Host: builder-api.decentraland.org
Accept: */*

301

Redirect to S3 URL

No content

Check if content exists

get

https://builder-api.decentraland.org/v1https://builder-api.decentraland.zone/v1

/storage/contents/{hash}/exists

Returns whether a file exists in storage without downloading it

Path parameters

hashstringRequired

Responses

200

File exists

404

File does not exist

get

/storage/contents/{hash}/exists

HTTPcURLJavaScriptPython

GET /v1/storage/contents/{hash}/exists HTTP/1.1
Host: builder-api.decentraland.org
Accept: */*

No content

Upload content file

post

https://builder-api.decentraland.org/v1https://builder-api.decentraland.zone/v1

/storage/upload

Uploads a file to storage

Authorizations

SignedFetch

X-Identity-Auth-Chain-*stringRequired

Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.

Body

multipart/form-data

objectOptional

Responses

200

File uploaded successfully

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

post

/storage/upload

HTTPcURLJavaScriptPython

POST /v1/storage/upload HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 2

{}

{
  "ok": true,
  "data": {
    "hash": "text"
  }
}