Skip to main content
PATCH
Update a Blob Custom Domain
Changes web_content on a custom domain and returns the domain. With true, the domain serves .html, .htm, .xhtml, .svg and .xml files in the browser with their real type; pages run JavaScript in a sandbox with no forms, no cookies and no navigating the top tab. With false (the default), those types always download. The change takes effect within about a minute. The default public link always downloads these types, whatever this setting says. See Custom domains for the risks. Scope: blob:write.
string
required
The domain ID.
boolean
Turns web content on (true) or off (false) for this domain.
string
The workspace ID, when the blob belongs to a workspace. The call acts on the blob of the workspace owner and needs the blob:read workspace permission (blob:manage on routes that change data). Leave it out to act on your own blob.

Example request

Response

object
The updated domain.

Error Responses

string
The error code indicating the reason for failure. Possible values:
  • AUTH_TOKEN_MISSING (401): No Authorization header was sent.
  • API_KEY_INVALID (401): The API key doesn’t exist, was revoked, or its secret doesn’t match.
  • API_KEY_SCOPE_DENIED (403): The key lacks the scope this route needs (blob:read or blob:write); details.required names it.
  • WORKSPACE_PERMISSION_DENIED (403): Only with workspace_id: you’re not a member, or your role lacks the blob permission.
  • WORKSPACE_NOT_FOUND (404): Only with workspace_id: no workspace with that ID, or you’re not a member.
  • VALIDATION_ERROR (400): web_content is missing or isn’t a boolean. details.path names the field.
  • BLOB_CUSTOM_DOMAIN_NOT_FOUND (404): No domain with that ID in this account.