Read the original and the crop behind a cropped image

GET

/image-crops

The record POST /image-crops saved for a cropped image, so the crop dialog can reopen on the original. The original holds whatever the crop cut away, so only the record's author, the image's owner (as POST /image-crops judges it) and staff who edit other people's images can read it; anybody else gets the same 404 as an image with no record, and the dialog then edits the image itself. Requires a bearer session.

Authorizations

BearerAuth

In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.

Type

HTTP (bearer)

Parameters

Query Parameters

url*

The cropped image's URL (output_url).

Type

string

Required

Format

"uri"

Max Length

2048

Responses

The original and the crops

Content-Type

application/json

{

"original_url": "string",

"crop": "string",

"secondary_crop": "string"

}

GET

/image-crops

Playground

Server

Authorization

BearerAuth

Variables

Key

Value

url*

Samples

Powered by VitePress OpenAPI