Sign in
Blob

Upload a blob

Changed on
post/blob

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/blob
  • Auth: HTTP bearer

Query parameters

pathnamestring

Path where the blob will be stored

content_typestring

Content type of the blob (optional, will be guessed from extension)

add_random_suffixboolean

Add random suffix to pathname to prevent collisions

project_idinteger

Project ID (required for API key/session auth, optional for deployment tokens)

Response

Blob uploaded successfully

contentTypestring required

Content type of the blob

pathnamestring required

Original pathname

sizeinteger required

Size in bytes

uploadedAtstring date-time required

Upload timestamp

urlstring required

URL path to access the blob

Example response

{
  "contentType": "image/png",
  "pathname": "images/avatar-abc123.png",
  "size": 12345,
  "uploadedAt": "2025-01-03T12:00:00Z",
  "url": "/api/blob/123/images/avatar-abc123.png"
}

Changes

  • 4b228ebed583Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 1dc3e6788214Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status