JustFlows

Management API / Media

Update media

PATCH/api/manage/v1/media/{id}

Changes a media item's alt text, caption, or focal point.

Authorization

  • Authorizationheaderrequired

    Bearer jfk_…: an API key created in Admin → Settings → API.

  • Required capabilitymedia:upload

    The key and its owner must both hold it. Content scopes on the key are applied to this request as well.

Path parameters

  • idstringrequired

    The resource id.

Body

application/json
  • altTextstring | null

    Up to 2,000 characters.

  • captionstring | null

    Up to 2,000 characters.

  • focalXnumber | null

    Horizontal focal point, 0–1.

  • focalYnumber | null

    Vertical focal point, 0–1.

Response

  • 200OK
  • 401Missing, unknown, revoked, expired, or out-of-scope key.
  • 403The key or its owner lacks the required capability or scope.
  • 404No such resource on this site.
  • 429Per-key or per-IP rate limit exceeded. Wait for the seconds in Retry-After.