images

Update Image Route

Update visibility, TTL, or the private view link of a hosted image.

Caller must own it.

ttl_seconds and permanent are mutually exclusive: providing both returns a validation error. permanent=true clears the expiry so the image lives indefinitely. ttl_seconds sets a new expiry relative to now. Omitting both leaves the current expiry unchanged.

rotate_view_secret=true issues a fresh private view link and invalidates every link shared earlier for this image (un-share). For a private image the returned url is the current view link.

patch/images/{image_id}

Request

  • Base URL: https://api.goodeye.dev/v1
  • URL: https://api.goodeye.dev/v1/images/{image_id}
  • Auth: none declared

Path parameters

image_idstring uuid required

Request body

visibilitystring nullable
ttl_secondsinteger nullable
permanentboolean
rotate_view_secretboolean

Response

Successful Response

object required

Changes

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