EaserixDocs
DevelopersAPI referenceLinksBio

Remove the page's avatar or background image

Deletes the stored object (if any) and clears the corresponding theme field. Idempotent — deleting an already-empty kind still returns 204.

View as Markdown
DELETE
/v1/bio/{id}/media/{kind}

Authorization

bearer
AuthorizationBearer <token>

In: header

Path Parameters

id*string
kind*string

Value in

  • "avatar"
  • "background"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/bio/string/media/avatar"
Empty

Upload the page's avatar or background image (multipart, "file" field, ≤5MB)

multipart/form-data upload to R2 (image/png, image/jpeg, image/webp, or image/gif). Sets theme.avatarUrl or theme.bgImageUrl depending on kind. If that field was already set, the previously-uploaded image is deleted from storage — replacing an image never leaves an orphaned object behind. 400 when kind is invalid, the file is missing, or the content type isn't one of the allowed image types; 413 when the file is larger than 5MB; 503 when image storage isn't configured for this environment.

Fetch a stored file (public, unauthenticated)

Generic public file-serving route shared by every feature that stores user-uploaded files through this service's media layer — bio-page avatar/background images today. Published bio pages are public, so the images they embed must be fetchable without a token; this proxies the stored object rather than exposing a raw bucket URL, matching the canvas asset-serving pattern.