/api/v1/objecttype
Read and write objecttypes — the per-record-type configuration that fylr layers on the datamodel definition (default masks, exposure flags, ACL, tags, transitions, mask / column filters, asset-filename policy, watermark and janitor policy). The objecttype itself (its name, fields and hierarchy) is part of the datamodel and is created through the schema endpoints; this endpoint only configures objecttypes that already exist in the current (committed) datamodel. A write updates the objecttype configuration directly and takes effect immediately when the request transaction commits — there is no working copy and no separate schema/commit step.
GET is open to any authenticated user; POST requires system.objecttypemanager. Authentication is by access token (a Bearer header or the access_token query parameter).
Differs from easydb 5: writes that touch collection ACLs are confirmed with the confirm / allow_invalid_acl / background_invalid_acl query parameters instead of easydb 5's single collection_rights_policy parameter.
GET /objecttype — List all objecttypes in the current datamodel.
Returns every objecttype in the current datamodel as an
array of descriptors. Any authenticated user may read; the
auxiliary fields that need system.objecttypemanager are included
only when that right is held (or are dropped entirely with
format=short).
Access token in the Authorization header:
Authorization: Bearer <token>.
Set format=short to omit the auxiliary fields that require
the system.objecttypemanager right (_acl, tags,
transitions, mask / column filters, etc.). Any other value,
or omitting the parameter, returns the full descriptor. Only
short is special-cased — there is no separate long /
standard behaviour.
Array of objecttype descriptors.
An objecttype descriptor — fylr's per-record-type configuration layered on top of the datamodel definition: per-objecttype default masks, exposure flags (frontend menus, collections, facets), ACL rules, tags, transitions, mask / column filters, asset filename policy, watermark and janitor (cleanup) policy.
Returned by /api/v1/objecttype and /api/v1/objecttype/{id}. The
same shape is accepted as the request body of POST /api/v1/objecttype
(only the fields the requester is allowed to mutate are honoured).
Fixed marker identifying this object as an objecttype.
Ordered list of mask ids to prefer when rendering objects of
this type. The first entry is the default mask. null (rather
than an empty array) signals "no preference defined" — the
datamodel's standard mask is then used.
It is also the fallback for indexing: an object is written to the
search index once per standard mask of its pool, a pool that lists
none inherits from its parent, and the root pool falls back to this
list — which in turn falls back to every mask of the objecttype.
Adding or removing a mask therefore raises the re-index 202 (see
confirm_reindex); pure reordering does not, it only picks the
preferred mask.
If true, transitions configured directly on this objecttype do not inherit transitions from the parent pool / global.
If true, the tag set configured on this objecttype shadows the inherited tags (does not merge with them).
No authenticated user. The request must carry a valid access token.
[
{
"_basetype": "objecttype",
"objecttype": {
"_id": 1,
"_version": 1,
"name": "text",
"contact": {},
"mapping_image_export": null,
"mapping_image_import": null,
"mapping_image_import_recipe_configs": {
"ANY_ADDITIONAL_PROPERTY": {
"imageconverter:browserthumbs": {
"params": {
"size": 1200,
"format": "webp",
"resize_mode": "max"
}
},
"imageconverter:preview_pool_watermark": {
"params": {
"size": 600,
"format": "jpg"
}
}
}
},
"mapping_dc_export": null,
"show_in_collections": true,
"show_in_facet_grouping": true,
"show_in_main_menu_with_icon": "text",
"empty_placeholder_icon": "text",
"standard_numbering": "text",
"description": {
"de-DE": "Deutscher text",
"en-US": "English text"
},
"custom_data": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"watermark": {
"image": {
"_id": 1,
"eas_parent_id": 1,
"reference": "text",
"upload_user": {
"_basetype": "user",
"user": {}
},
"date_uploaded": "text",
"best_date": "text",
"filesize": 1,
"status": "text",
"last_status_at": "text",
"extension": "text",
"class": "text",
"class_version_status": "text",
"class_extension": "text",
"is_original": true,
"hash": "text",
"technical_metadata": {
"width": 1920,
"height": 1440,
"dpi": 1,
"colorspace": "rgb",
"format": "landscape",
"mime_type": "image/jpeg",
"file_type_extension": "jpg",
"filesize": 885714,
"dimensions": {
"width": 1920,
"height": 1440,
"unit": "px"
},
"sha256_hash": "2f19a9fd4ad56217899e275c0177a14e40a3061cc96ea0747ce973877aead14c",
"huhu": {
"gut": "sieht torsten custom:und henk"
}
},
"compiled": "text",
"compiled_props": {
"extension": "text",
"dimensions": "text",
"duration": "text",
"pages": "text"
},
"_mapped_metadata": {
"_objecttype": "text",
"_mask": "text",
"_system_object_id": 1,
"_global_object_id": "text",
"_uuid": "text",
"_owner": {
"_basetype": "user",
"_owner": true,
"_pool_contact": true,
"user": {
"_id": 1,
"lookup:_id": {
"reference": "text"
},
"_generated_displayname": "text",
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"group": {
"_id": 1,
"lookup:_id": {
"reference": "text"
},
"_generated_displayname": "text"
}
},
"_created": "text",
"{objecttype}": {
"_id": 1,
"_version": 1,
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"metadata": {
"groupnames": [
"text"
],
"groups": {
"ANY_ADDITIONAL_PROPERTY": [
{
"value": null,
"print": "text",
"name": "text",
"group": "text"
}
]
}
},
"original_filepath": "text",
"original_filename": "text",
"original_filename_basename": "text",
"versions": {
"ANY_ADDITIONAL_PROPERTY": {
"_id": "text",
"aspect_ratio": "text",
"blurhash": "text",
"class": "text",
"class_extension": "text",
"date_created": "text",
"_download_allowed": true,
"_show_allowed": true,
"dpi": "text",
"extension": "text",
"filesize": "text",
"hash": "text",
"height": "text",
"last_status_at": "text",
"orientation": "text",
"percent_done": "text",
"status": "text",
"url": "text",
"zoom_url": "text",
"iiif_url": "text",
"deep_link_url": "text",
"watermark": "text",
"width": "text",
"path": "text",
"technical_metadata": "text"
}
},
"_duplicates": [
{
"_id": 1,
"certainty": 1,
"linked_system_objects": [
{
"_system_object_id": 1,
"_column_id": 1
}
]
}
],
"_linked_objects": [
{
"_system_object_id": 1,
"_version": 1
}
],
"preferred": true,
"name": "text",
"frontend_prefs": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"lookup:_id": {
"reference": "text"
}
},
"gravity": "se",
"dissolve": 1,
"size": "text",
"tile": true
},
"caption": {
"ANY_ADDITIONAL_PROPERTY": {
"text": "text",
"size": "24",
"padding": "8",
"multiline": true,
"overlay": true
}
},
"janitor_policy": {
"file_link_delete": {
"keep_days_history_versions": 1,
"keep_count_history_versions": 1
},
"object_purge": {
"min_deleted_days": 1
}
}
},
"_standard_masks": [
1
],
"_export_asset_filenames": {
"ANY_ADDITIONAL_PROPERTY": {
"de-DE": "Deutscher text",
"en-US": "English text"
}
},
"_acl": [
{
"_id": 1,
"who": {
"_basetype": "user",
"_owner": true,
"_pool_contact": true,
"user": {
"_id": 1,
"lookup:_id": {
"reference": "text"
},
"_generated_displayname": "text",
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"group": {
"_id": 1,
"lookup:_id": {
"reference": "text"
},
"_generated_displayname": "text"
}
},
"sticky": true,
"active": true,
"_right_preset": 1,
"when": {
"from": "2026-01-01T00:00:00.000Z",
"to": "2026-01-01T00:00:00.000Z"
},
"rights": {
"ANY_ADDITIONAL_PROPERTY": {
"_grantable": true,
"allow_update_and_remove": true,
"classes": [
"text"
],
"extensions": [
"text"
],
"versions": [
"text"
],
"limit": 1,
"mask_ids": {
"ANY_ADDITIONAL_PROPERTY": []
},
"column_ids": [
1
],
"objecttype_ids": [
1
],
"pool_ids": [
1
]
}
},
"tagfilter": {
"all": [
1
],
"any": [
1
],
"not": [
1
],
"changed": [
1
]
},
"send_email_notification": {
"text": "text"
}
}
],
"_private_transitions": true,
"_transitions": [
{
"type": "process",
"operations": [
"INSERT",
"UPDATE"
],
"sticky": false,
"objecttype_ids": [
1
],
"actions": [
{
"type": "set_tags",
"info": {
"tags": [
{
"_id": 5,
"set": true
}
]
}
}
],
"who": [
{
"_basetype": "user",
"user": {
"_id": 1
}
}
]
}
],
"_private_tags": true,
"_tags": [
{
"_id": 1,
"displayname": {
"de-DE": "Dogs"
},
"enabled": true,
"displaytype": "detail",
"sticky": true
}
],
"_compiled_tags": [
{
"_id": 1,
"displayname": {
"de-DE": "Dogs"
},
"enabled": true,
"displaytype": "detail",
"sticky": true
}
],
"_maskfilters": {
"ANY_ADDITIONAL_PROPERTY": {
"tagfilter": {
"all": [
1
],
"any": [
1
],
"not": [
1
],
"changed": [
1
]
}
}
},
"_columnfilters": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"_filename_replacements": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
}
}
]POST /objecttype — Create or update the settings of one or more objecttypes.
From 6.35.0 a change to an objecttype's standard masks is answered with 202 and a count of the records it re-indexes; repeat the request with confirm_reindex=yes (confirmReindex=yes in 6.35.0) to queue them into the running index. From 6.35.1 a change that affects no record saves without the 202, and confirm_reindex=skip (needs system.root) saves without queuing the records, for a client that re-indexes afterwards, like fylr restore. See Masks.
Updates the configuration of an array of objecttypes directly. The
objecttypes must already exist in the committed datamodel; this
endpoint writes their settings, not their structure. The change
takes effect immediately when the request transaction commits —
there is no schema/commit step. The user needs
system.objecttypemanager (or system.root). When the instance is
in read-only mode the request is rejected before processing (see
the 400 response).
The objecttype itself (its name, fields, hierarchy) is defined by
the datamodel, not created here — every element must carry an
existing objecttype._id, and objecttype._version must be
current + 1 (optimistic locking; a mismatch is a 400
VersionMismatch). Only the configuration fields are mutated;
fields the requester is not allowed to change are ignored. Fields
omitted from the body keep their stored value (the server reloads
the current objecttype and merges). Notable parse rules:
mapping_*fields take a mapping id or the string"none"to clear;mapping_image_import_recipe_configsmay only be set whenmapping_image_importnames a real mapping._standard_masks:nullclears the preference; a non-empty array of mask ids sets it; an empty array[]is rejected (ObjecttypeNeedsStandardMask).watermark.gravity, if present, must be one ofnw n ne w c e sw s seor empty.captionkeys must each name an existing files field that is not inside a reverse-nested and whose objecttype's pool management matches the endpoint (objecttype, not pool).janitor_policybounds must benullor>= 0.janitor_policyis only meaningful for non-pool objecttypes; for a pool objecttype it is neither stored nor returned. The key is merged from the stored value only when omitted — sendingnullexplicitly clears it.standard_numberingis accepted for compatibility but ignored (never stored, always returned empty)._maskfiltersreplaces the stored mask filters wholesale, so sending it as{}clears them. Any difference to the stored ones raises the mask-filter 202 (seeconfirm_reindex), because the search index only follows the new filters once the objects have been indexed again.
The save can pause and return a 202 to ask for confirmation (see the 202 response). The query parameters below are how the client answers those confirmations: it re-sends the same request body with the matching parameter appended.
Differs from easydb 5: the 202 confirmation contract uses
confirm / allow_invalid_acl / background_invalid_acl rather
than easydb 5's collection_rights_policy.
Access token in the Authorization header:
Authorization: Bearer <token>.
Answer to the renditions-resync 202 that is raised when a
watermark or caption change requires recomputing the
renditions of already-stored files. resync recomputes them
now; skip saves without recomputing. Any other value is
rejected with a generic 400 (confirm "<value>" not supported).
Confirms the re-index 202 that is raised when the submitted
_maskfilters differ from the stored ones, or when
_standard_masks lists other masks than before. Reordering is
not a difference in either case: the order picks the best mask
per search request and changes no document. Both settings
decide whether, and under which mask, an object is written to
the search index, and both are evaluated while indexing — so
the change only takes effect once the objects are indexed
again.
The task offers no opt-out: the re-index is what makes the
index match the new configuration, so the 202 only announces
it. Its data.object_count says how many objects are affected;
when that is 0 there is nothing to re-index and the save goes
through without the task. On
confirmation the save queues every latest-version object of
the affected objecttypes into the running index at low
priority — documents that are now excluded are deleted, newly
included ones are written, no new index is built and the
frontend is not blocked.
skip answers the task as well but queues no object: the
index keeps the documents of the old configuration until the
objects are indexed again. It is meant for a client that
re-indexes on its own afterwards, like fylr restore, which
runs POST /api/v1/system/reindex when it is done, and needs
system.root (403 SystemRightRequired otherwise).
Any value other than yes and skip is rejected with a
generic 400 (confirm_reindex "<value>" not supported). Sending the
parameter when nothing changed is harmless.
Answer to the invalid-collection-ACL 202. When true, a save
whose ACL change would invalidate a collection the owner can
no longer fully grant is allowed to proceed; the affected
collections are flagged invalid_acl and sharing for them is
disabled. If the user lacks bag-acl on such a collection the
request instead fails with UrlParameterNotSupported for
allow_invalid_acl.
Answer to the ACL-revalidation timeout 202. When true, the
collection-ACL revalidation runs as an asynchronous background
task and the request returns immediately instead of completing
the check synchronously.
Overrides the synchronous time budget before the timeout 202
is offered. A Go duration string (e.g. 5s); an invalid value
surfaces as a generic 400.
An objecttype descriptor — fylr's per-record-type configuration layered on top of the datamodel definition: per-objecttype default masks, exposure flags (frontend menus, collections, facets), ACL rules, tags, transitions, mask / column filters, asset filename policy, watermark and janitor (cleanup) policy.
Returned by /api/v1/objecttype and /api/v1/objecttype/{id}. The
same shape is accepted as the request body of POST /api/v1/objecttype
(only the fields the requester is allowed to mutate are honoured).
Fixed marker identifying this object as an objecttype.
Ordered list of mask ids to prefer when rendering objects of
this type. The first entry is the default mask. null (rather
than an empty array) signals "no preference defined" — the
datamodel's standard mask is then used.
It is also the fallback for indexing: an object is written to the
search index once per standard mask of its pool, a pool that lists
none inherits from its parent, and the root pool falls back to this
list — which in turn falls back to every mask of the objecttype.
Adding or removing a mask therefore raises the re-index 202 (see
confirm_reindex); pure reordering does not, it only picks the
preferred mask.
If true, transitions configured directly on this objecttype do not inherit transitions from the parent pool / global.
If true, the tag set configured on this objecttype shadows the inherited tags (does not merge with them).
The objecttypes were saved. The body echoes the saved
descriptors (with _acl, tags, transitions and mask filters
included). The X-Fylr-Cache-ID response header carries the
new datamodel cache id so clients can invalidate caches.
The save needs confirmation before it can complete — nothing
was written. Resubmit the identical request with the query
parameter named by each task's form option or button appended
— for example allow_invalid_acl=true,
background_invalid_acl=true, confirm=resync /
confirm=skip, or confirm_reindex=yes. More than one
task can be open at a time; answer them all in one resend.
The request could not be processed. All errors below are
realm: api, statuscode: 400. The objecttype-specific codes
(package: objecttype) are UnknownField /
UnsupportedFieldType, both raised while resolving an
_export_asset_filenames template against the datamodel.
The body parse and the ApiToObject validation add several
package: ferrors codes:
ReadOnlyMode— the instance is in read-only mode; the request is rejected before any processing (messageRead-only mode is enabled.).VersionMismatch— a submitted objecttype's_versionis notcurrent + 1.parameters.got/parameters.expectedcarry the values.ObjecttypeNeedsStandardMask—_standard_maskswas sent as an empty array ([]); sendnullto clear the preference instead.parameters.namecarries the objecttype name.UrlParameterNotSupported—allow_invalid_acl=truewas sent but the user lacksbag-aclon an affected collection.parameters.paramisallow_invalid_acl.
CustomDataFileNoRights (package: rightcheck): a key ending
in :eas_file in custom_data names a file the objecttype does
not hold yet and the user may not load. parameters.fileid
carries the file id.
Generic 400s (code: ServerGeneric or a bare message) also
surface here for: an unsupported confirm value (confirm "<value>" not supported); an unsupported confirm_reindex
value (confirm_reindex "<value>" not supported); an
unknown _standard_masks /
_maskfilters mask id (Objecttype: Mask <id> not found in Datamodel); a watermark.gravity outside the allowed set
(watermark.gravity "<value>" not supported); an out-of-range
janitor_policy bound (a negative value;
janitor_policy.file_link_delete.keep_days_history_versions must be null or > 0 and the analogous keep_count /
min_object_deleted_days messages); a bad caption
(caption "<field>": field not found, ... must not be inside a reverse nested, ... is not of type "file", or a
pool-management mismatch); recipe configs set while
mapping_image_import is "none" (mapping recipe configs can only be set for a specific mapping); own transitions / tags on
an objecttype whose pool does not allow them (Objecttype "<name>" cannot have own transitions / ... own tags); a bad
background_invalid_acl_timelimit duration. Datamodel-validation,
save-pipeline and DB-driver errors (e.g.
DatabaseUniqueKeyViolation) can appear too. The code enum
on the schema lists only the two objecttype codes; it is not
exhaustive.
No authenticated user. The request must carry a valid access token.
The authenticated user lacks the system right required for
the operation (system.objecttypemanager, or system.root).
The write could not acquire a database lock because a
concurrent write is touching the same rows (PostgreSQL
55P03). The transaction is rolled back and the error is
surfaced as code: DatabaseLockError, package: ferrors,
statuscode: 423. Retry the identical request once the
conflicting write has finished.
[
{
"_basetype": "objecttype",
"objecttype": {
"_id": 1,
"_version": 1,
"name": "text",
"contact": {},
"mapping_image_export": null,
"mapping_image_import": null,
"mapping_image_import_recipe_configs": {
"ANY_ADDITIONAL_PROPERTY": {
"imageconverter:browserthumbs": {
"params": {
"size": 1200,
"format": "webp",
"resize_mode": "max"
}
},
"imageconverter:preview_pool_watermark": {
"params": {
"size": 600,
"format": "jpg"
}
}
}
},
"mapping_dc_export": null,
"show_in_collections": true,
"show_in_facet_grouping": true,
"show_in_main_menu_with_icon": "text",
"empty_placeholder_icon": "text",
"standard_numbering": "text",
"description": {
"de-DE": "Deutscher text",
"en-US": "English text"
},
"custom_data": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"watermark": {
"image": {
"_id": 1,
"eas_parent_id": 1,
"reference": "text",
"upload_user": {
"_basetype": "user",
"user": {}
},
"date_uploaded": "text",
"best_date": "text",
"filesize": 1,
"status": "text",
"last_status_at": "text",
"extension": "text",
"class": "text",
"class_version_status": "text",
"class_extension": "text",
"is_original": true,
"hash": "text",
"technical_metadata": {
"width": 1920,
"height": 1440,
"dpi": 1,
"colorspace": "rgb",
"format": "landscape",
"mime_type": "image/jpeg",
"file_type_extension": "jpg",
"filesize": 885714,
"dimensions": {
"width": 1920,
"height": 1440,
"unit": "px"
},
"sha256_hash": "2f19a9fd4ad56217899e275c0177a14e40a3061cc96ea0747ce973877aead14c",
"huhu": {
"gut": "sieht torsten custom:und henk"
}
},
"compiled": "text",
"compiled_props": {
"extension": "text",
"dimensions": "text",
"duration": "text",
"pages": "text"
},
"_mapped_metadata": {
"_objecttype": "text",
"_mask": "text",
"_system_object_id": 1,
"_global_object_id": "text",
"_uuid": "text",
"_owner": {
"_basetype": "user",
"_owner": true,
"_pool_contact": true,
"user": {
"_id": 1,
"lookup:_id": {
"reference": "text"
},
"_generated_displayname": "text",
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"group": {
"_id": 1,
"lookup:_id": {
"reference": "text"
},
"_generated_displayname": "text"
}
},
"_created": "text",
"{objecttype}": {
"_id": 1,
"_version": 1,
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"metadata": {
"groupnames": [
"text"
],
"groups": {
"ANY_ADDITIONAL_PROPERTY": [
{
"value": null,
"print": "text",
"name": "text",
"group": "text"
}
]
}
},
"original_filepath": "text",
"original_filename": "text",
"original_filename_basename": "text",
"versions": {
"ANY_ADDITIONAL_PROPERTY": {
"_id": "text",
"aspect_ratio": "text",
"blurhash": "text",
"class": "text",
"class_extension": "text",
"date_created": "text",
"_download_allowed": true,
"_show_allowed": true,
"dpi": "text",
"extension": "text",
"filesize": "text",
"hash": "text",
"height": "text",
"last_status_at": "text",
"orientation": "text",
"percent_done": "text",
"status": "text",
"url": "text",
"zoom_url": "text",
"iiif_url": "text",
"deep_link_url": "text",
"watermark": "text",
"width": "text",
"path": "text",
"technical_metadata": "text"
}
},
"_duplicates": [
{
"_id": 1,
"certainty": 1,
"linked_system_objects": [
{
"_system_object_id": 1,
"_column_id": 1
}
]
}
],
"_linked_objects": [
{
"_system_object_id": 1,
"_version": 1
}
],
"preferred": true,
"name": "text",
"frontend_prefs": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"lookup:_id": {
"reference": "text"
}
},
"gravity": "se",
"dissolve": 1,
"size": "text",
"tile": true
},
"caption": {
"ANY_ADDITIONAL_PROPERTY": {
"text": "text",
"size": "24",
"padding": "8",
"multiline": true,
"overlay": true
}
},
"janitor_policy": {
"file_link_delete": {
"keep_days_history_versions": 1,
"keep_count_history_versions": 1
},
"object_purge": {
"min_deleted_days": 1
}
}
},
"_standard_masks": [
1
],
"_export_asset_filenames": {
"ANY_ADDITIONAL_PROPERTY": {
"de-DE": "Deutscher text",
"en-US": "English text"
}
},
"_acl": [
{
"_id": 1,
"who": {
"_basetype": "user",
"_owner": true,
"_pool_contact": true,
"user": {
"_id": 1,
"lookup:_id": {
"reference": "text"
},
"_generated_displayname": "text",
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"group": {
"_id": 1,
"lookup:_id": {
"reference": "text"
},
"_generated_displayname": "text"
}
},
"sticky": true,
"active": true,
"_right_preset": 1,
"when": {
"from": "2026-01-01T00:00:00.000Z",
"to": "2026-01-01T00:00:00.000Z"
},
"rights": {
"ANY_ADDITIONAL_PROPERTY": {
"_grantable": true,
"allow_update_and_remove": true,
"classes": [
"text"
],
"extensions": [
"text"
],
"versions": [
"text"
],
"limit": 1,
"mask_ids": {
"ANY_ADDITIONAL_PROPERTY": []
},
"column_ids": [
1
],
"objecttype_ids": [
1
],
"pool_ids": [
1
]
}
},
"tagfilter": {
"all": [
1
],
"any": [
1
],
"not": [
1
],
"changed": [
1
]
},
"send_email_notification": {
"text": "text"
}
}
],
"_private_transitions": true,
"_transitions": [
{
"type": "process",
"operations": [
"INSERT",
"UPDATE"
],
"sticky": false,
"objecttype_ids": [
1
],
"actions": [
{
"type": "set_tags",
"info": {
"tags": [
{
"_id": 5,
"set": true
}
]
}
}
],
"who": [
{
"_basetype": "user",
"user": {
"_id": 1
}
}
]
}
],
"_private_tags": true,
"_tags": [
{
"_id": 1,
"displayname": {
"de-DE": "Dogs"
},
"enabled": true,
"displaytype": "detail",
"sticky": true
}
],
"_compiled_tags": [
{
"_id": 1,
"displayname": {
"de-DE": "Dogs"
},
"enabled": true,
"displaytype": "detail",
"sticky": true
}
],
"_maskfilters": {
"ANY_ADDITIONAL_PROPERTY": {
"tagfilter": {
"all": [
1
],
"any": [
1
],
"not": [
1
],
"changed": [
1
]
}
}
},
"_columnfilters": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"_filename_replacements": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
}
}
]GET /objecttype/{id} — Retrieve a single objecttype.
Loads one objecttype by numeric id and returns it wrapped in a
one-element array (the descriptor is the only array entry — the
response is not a bare object).
Access token in the Authorization header:
Authorization: Bearer <token>.
The numeric id of the objecttype. The path segment must be a
positive integer (route pattern [1-9][0-9]*); name-based
lookup is not supported on this endpoint.
Set format=short to omit the auxiliary fields that require
the system.objecttypemanager right (_acl, tags,
transitions, mask / column filters, etc.). Any other value,
or omitting the parameter, returns the full descriptor. Only
short is special-cased — there is no separate long /
standard behaviour.
A one-element array containing the objecttype descriptor.
An objecttype descriptor — fylr's per-record-type configuration layered on top of the datamodel definition: per-objecttype default masks, exposure flags (frontend menus, collections, facets), ACL rules, tags, transitions, mask / column filters, asset filename policy, watermark and janitor (cleanup) policy.
Returned by /api/v1/objecttype and /api/v1/objecttype/{id}. The
same shape is accepted as the request body of POST /api/v1/objecttype
(only the fields the requester is allowed to mutate are honoured).
Fixed marker identifying this object as an objecttype.
Ordered list of mask ids to prefer when rendering objects of
this type. The first entry is the default mask. null (rather
than an empty array) signals "no preference defined" — the
datamodel's standard mask is then used.
It is also the fallback for indexing: an object is written to the
search index once per standard mask of its pool, a pool that lists
none inherits from its parent, and the root pool falls back to this
list — which in turn falls back to every mask of the objecttype.
Adding or removing a mask therefore raises the re-index 202 (see
confirm_reindex); pure reordering does not, it only picks the
preferred mask.
If true, transitions configured directly on this objecttype do not inherit transitions from the parent pool / global.
If true, the tag set configured on this objecttype shadows the inherited tags (does not merge with them).
The numeric id in the URL does not match any objecttype in
the current datamodel. The load fails and is reported as a
generic server error (code: ServerGeneric, package: ferrors, statuscode: 400) with a message of the form
Server error occurred: objecttype.LoadById: Error loading: ObjecttypeList.Load: Not all objecttypes found in DB — there
is no structured 404 for an unknown id on this endpoint.
No authenticated user. The request must carry a valid access token.
[
{
"_basetype": "objecttype",
"objecttype": {
"_id": 1,
"_version": 1,
"name": "text",
"contact": {},
"mapping_image_export": null,
"mapping_image_import": null,
"mapping_image_import_recipe_configs": {
"ANY_ADDITIONAL_PROPERTY": {
"imageconverter:browserthumbs": {
"params": {
"size": 1200,
"format": "webp",
"resize_mode": "max"
}
},
"imageconverter:preview_pool_watermark": {
"params": {
"size": 600,
"format": "jpg"
}
}
}
},
"mapping_dc_export": null,
"show_in_collections": true,
"show_in_facet_grouping": true,
"show_in_main_menu_with_icon": "text",
"empty_placeholder_icon": "text",
"standard_numbering": "text",
"description": {
"de-DE": "Deutscher text",
"en-US": "English text"
},
"custom_data": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"watermark": {
"image": {
"_id": 1,
"eas_parent_id": 1,
"reference": "text",
"upload_user": {
"_basetype": "user",
"user": {}
},
"date_uploaded": "text",
"best_date": "text",
"filesize": 1,
"status": "text",
"last_status_at": "text",
"extension": "text",
"class": "text",
"class_version_status": "text",
"class_extension": "text",
"is_original": true,
"hash": "text",
"technical_metadata": {
"width": 1920,
"height": 1440,
"dpi": 1,
"colorspace": "rgb",
"format": "landscape",
"mime_type": "image/jpeg",
"file_type_extension": "jpg",
"filesize": 885714,
"dimensions": {
"width": 1920,
"height": 1440,
"unit": "px"
},
"sha256_hash": "2f19a9fd4ad56217899e275c0177a14e40a3061cc96ea0747ce973877aead14c",
"huhu": {
"gut": "sieht torsten custom:und henk"
}
},
"compiled": "text",
"compiled_props": {
"extension": "text",
"dimensions": "text",
"duration": "text",
"pages": "text"
},
"_mapped_metadata": {
"_objecttype": "text",
"_mask": "text",
"_system_object_id": 1,
"_global_object_id": "text",
"_uuid": "text",
"_owner": {
"_basetype": "user",
"_owner": true,
"_pool_contact": true,
"user": {
"_id": 1,
"lookup:_id": {
"reference": "text"
},
"_generated_displayname": "text",
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"group": {
"_id": 1,
"lookup:_id": {
"reference": "text"
},
"_generated_displayname": "text"
}
},
"_created": "text",
"{objecttype}": {
"_id": 1,
"_version": 1,
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"metadata": {
"groupnames": [
"text"
],
"groups": {
"ANY_ADDITIONAL_PROPERTY": [
{
"value": null,
"print": "text",
"name": "text",
"group": "text"
}
]
}
},
"original_filepath": "text",
"original_filename": "text",
"original_filename_basename": "text",
"versions": {
"ANY_ADDITIONAL_PROPERTY": {
"_id": "text",
"aspect_ratio": "text",
"blurhash": "text",
"class": "text",
"class_extension": "text",
"date_created": "text",
"_download_allowed": true,
"_show_allowed": true,
"dpi": "text",
"extension": "text",
"filesize": "text",
"hash": "text",
"height": "text",
"last_status_at": "text",
"orientation": "text",
"percent_done": "text",
"status": "text",
"url": "text",
"zoom_url": "text",
"iiif_url": "text",
"deep_link_url": "text",
"watermark": "text",
"width": "text",
"path": "text",
"technical_metadata": "text"
}
},
"_duplicates": [
{
"_id": 1,
"certainty": 1,
"linked_system_objects": [
{
"_system_object_id": 1,
"_column_id": 1
}
]
}
],
"_linked_objects": [
{
"_system_object_id": 1,
"_version": 1
}
],
"preferred": true,
"name": "text",
"frontend_prefs": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"lookup:_id": {
"reference": "text"
}
},
"gravity": "se",
"dissolve": 1,
"size": "text",
"tile": true
},
"caption": {
"ANY_ADDITIONAL_PROPERTY": {
"text": "text",
"size": "24",
"padding": "8",
"multiline": true,
"overlay": true
}
},
"janitor_policy": {
"file_link_delete": {
"keep_days_history_versions": 1,
"keep_count_history_versions": 1
},
"object_purge": {
"min_deleted_days": 1
}
}
},
"_standard_masks": [
1
],
"_export_asset_filenames": {
"ANY_ADDITIONAL_PROPERTY": {
"de-DE": "Deutscher text",
"en-US": "English text"
}
},
"_acl": [
{
"_id": 1,
"who": {
"_basetype": "user",
"_owner": true,
"_pool_contact": true,
"user": {
"_id": 1,
"lookup:_id": {
"reference": "text"
},
"_generated_displayname": "text",
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"group": {
"_id": 1,
"lookup:_id": {
"reference": "text"
},
"_generated_displayname": "text"
}
},
"sticky": true,
"active": true,
"_right_preset": 1,
"when": {
"from": "2026-01-01T00:00:00.000Z",
"to": "2026-01-01T00:00:00.000Z"
},
"rights": {
"ANY_ADDITIONAL_PROPERTY": {
"_grantable": true,
"allow_update_and_remove": true,
"classes": [
"text"
],
"extensions": [
"text"
],
"versions": [
"text"
],
"limit": 1,
"mask_ids": {
"ANY_ADDITIONAL_PROPERTY": []
},
"column_ids": [
1
],
"objecttype_ids": [
1
],
"pool_ids": [
1
]
}
},
"tagfilter": {
"all": [
1
],
"any": [
1
],
"not": [
1
],
"changed": [
1
]
},
"send_email_notification": {
"text": "text"
}
}
],
"_private_transitions": true,
"_transitions": [
{
"type": "process",
"operations": [
"INSERT",
"UPDATE"
],
"sticky": false,
"objecttype_ids": [
1
],
"actions": [
{
"type": "set_tags",
"info": {
"tags": [
{
"_id": 5,
"set": true
}
]
}
}
],
"who": [
{
"_basetype": "user",
"user": {
"_id": 1
}
}
]
}
],
"_private_tags": true,
"_tags": [
{
"_id": 1,
"displayname": {
"de-DE": "Dogs"
},
"enabled": true,
"displaytype": "detail",
"sticky": true
}
],
"_compiled_tags": [
{
"_id": 1,
"displayname": {
"de-DE": "Dogs"
},
"enabled": true,
"displaytype": "detail",
"sticky": true
}
],
"_maskfilters": {
"ANY_ADDITIONAL_PROPERTY": {
"tagfilter": {
"all": [
1
],
"any": [
1
],
"not": [
1
],
"changed": [
1
]
}
}
},
"_columnfilters": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"_filename_replacements": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
}
}
]GET /objecttype/{id}/stats — Asset statistics for an objecttype.
Aggregates, in SQL, the originals and their renditions across all
latest / history / deleted objects of the type, bucketing by file
class and extension. Requires the system.objecttypemanager right
(or system.root).
Access token in the Authorization header:
Authorization: Bearer <token>.
The numeric id of the objecttype (positive integer; route
pattern [1-9][0-9]*). Name-based lookup is not supported.
Asset statistics for the objecttype — file counts and storage usage rolled up across every object of the type.
Asset statistics for one objecttype — the rolled-up file counts and storage usage across every object of the type.
The numeric id in the URL does not match any objecttype in
the current datamodel. The load fails and is reported as a
generic server error (code: ServerGeneric, package: ferrors, statuscode: 400) with a message of the form
Server error occurred: objecttype.LoadById: Error loading: ObjecttypeList.Load: Not all objecttypes found in DB — there
is no structured 404 for an unknown id on this endpoint.
No authenticated user. The request must carry a valid access token.
The authenticated user lacks the system right required for
the operation (system.objecttypemanager, or system.root).
{
"files": {
"count": 1,
"size": 1,
"originals": {
"latest": {
"size": 1,
"count": 1,
"by_extension": {
"ANY_ADDITIONAL_PROPERTY": {
"size": 1,
"count": 1
}
},
"by_class": {
"ANY_ADDITIONAL_PROPERTY": {
"size": 1,
"count": 1
}
}
},
"history": {
"size": 1,
"count": 1,
"by_extension": {
"ANY_ADDITIONAL_PROPERTY": {
"size": 1,
"count": 1
}
},
"by_class": {
"ANY_ADDITIONAL_PROPERTY": {
"size": 1,
"count": 1
}
}
},
"deleted": {
"size": 1,
"count": 1,
"by_extension": {
"ANY_ADDITIONAL_PROPERTY": {
"size": 1,
"count": 1
}
},
"by_class": {
"ANY_ADDITIONAL_PROPERTY": {
"size": 1,
"count": 1
}
}
}
},
"versions": {
"latest": {
"size": 1,
"count": 1,
"by_extension": {
"ANY_ADDITIONAL_PROPERTY": {
"size": 1,
"count": 1
}
},
"by_class": {
"ANY_ADDITIONAL_PROPERTY": {
"size": 1,
"count": 1
}
}
},
"history": {
"size": 1,
"count": 1,
"by_extension": {
"ANY_ADDITIONAL_PROPERTY": {
"size": 1,
"count": 1
}
},
"by_class": {
"ANY_ADDITIONAL_PROPERTY": {
"size": 1,
"count": 1
}
}
},
"deleted": {
"size": 1,
"count": 1,
"by_extension": {
"ANY_ADDITIONAL_PROPERTY": {
"size": 1,
"count": 1
}
},
"by_class": {
"ANY_ADDITIONAL_PROPERTY": {
"size": 1,
"count": 1
}
}
}
}
}
}Last updated