> For the complete documentation index, see [llms.txt](https://docs.fylr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fylr.io/for-developers/api/endpoints/api-objecttype.md).

# /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.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/objecttype" method="get" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-27a76749464f8079ac8ce2ee65518544084ed6fa%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `POST /objecttype` — Create or update the settings of one or more objecttypes.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/objecttype" method="post" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-27a76749464f8079ac8ce2ee65518544084ed6fa%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `GET /objecttype/{id}` — Retrieve a single objecttype.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/objecttype/{id}" method="get" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-27a76749464f8079ac8ce2ee65518544084ed6fa%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `GET /objecttype/{id}/stats` — Asset statistics for an objecttype.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/objecttype/{id}/stats" method="get" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-27a76749464f8079ac8ce2ee65518544084ed6fa%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}