Storage

Create a Vercel Blob-compatible store for a project: unchanged @vercel/blob code works with its token and API URL (token shown once)

post/storage/vercel-blob-stores

Request

  • Base URL: https://hostingsurge.com/api/v1
  • URL: https://hostingsurge.com/api/v1/storage/vercel-blob-stores
  • Auth: one of:
    • HTTP bearer
    • API key in cookie __Host-hs_session

Query parameters

orgIdstring

Organization id (when the project could be in several of your teams)

Request body

projectIdstring uuid required

the project whose app uses the store

access'public' | 'private'

public: files are readable by anyone with their URL; private: only with the store's token

legacyStoreIdsstring[]

ids of the Vercel Blob stores this one replaces: their old file URLs keep working in head, delete, copy and rename

quotaBytesinteger

storage quota of the store's bucket (default 1 GiB, capped by what your team has left)

Response

Created

storeIdstring required
organizationIdstring uuid required
projectIdstring uuid nullable required
bucketIdstring uuid required

the storage bucket that holds the files (it counts toward your storage allowance)

bucketstring required

its S3 name

access'public' | 'private' required

public: files are readable by anyone with their URL; private: only with the store's token

legacyStoreIdsstring[] required
apiUrlstring required

VERCEL_BLOB_API_URL / NEXT_PUBLIC_VERCEL_BLOB_API_URL for the app

publicBaseUrlstring nullable required

where public files are served: <publicBaseUrl><pathname>

createdAtstring required

ISO-8601 timestamp

updatedAtstring required

ISO-8601 timestamp

tokenstring required

BLOB_READ_WRITE_TOKEN for the app: shown only in this response

webhookPublicKeystring nullable required

BLOB_WEBHOOK_PUBLIC_KEY: verifies callbacks of presigned uploads

Changes

No recorded changes to this operation across all 1 revision of this API.