/produce

This endpoint is used to produce a new version of the file. It allows to crop and rotate images. The new file gets a new id. The produce_version setting from the parent is inherited.

Differs from easydb 5: easydb 5 accepts a description field (optional l10n) in the produce body; fylr ignores it — the request only reads eas_parent_id, format and transform.

POST /eas/produce

post

Authorizations

BearerAuthAccessTokenQueryFylrAuthHeader

AuthorizationstringRequired

Access token in the Authorization header: Authorization: Bearer <token>.

Query parameters

obj_uuidstringOptional

The _uuid of the object the file is linked into. This is used for the permission check.

Body

application/json

eas_parent_idnumber · int64Optional

The file "original" the new produced version should be created from.

formatstring · enumOptional

The target format of the produced file. Defaults to the extension of the file parent.

Possible values:

Responses

200

The newly created file will be returned.

application/json

objectOptional

The file rendering in long format.

400

The produce request could not be processed — typical reasons are EasNoParentID (no / zero eas_parent_id), ProduceOriginalOnly (the parent is not an original), ProduceExtensionNotSupported and ProduceFormatNotSupported. ReadOnlyMode is returned if the instance is read-only. An eas_parent_id that does not match any stored file surfaces as a generic 400 error (ServerGeneric), not a 404.

application/json

403

The caller may not produce a version of the parent: it is neither the parent's uploader nor a user with RIGHT_WRITE + RIGHT_ASSET_UPLOAD on a linked object. The code is InsufficientRights (the caller cannot even see the parent) or RightRequired (visible but not producible). This endpoint returns no 401; a missing or invalid token is treated as an anonymous request and rejected with 403.

application/json

{}