# 2025-04-03: Schema Service - endpoints for managing custom entities and instances

## Overview

We added new API for managing custom schema types and custom instances. Custom schema types are custom entities on which you can build custom instances.

## Added endpoints

| Endpoint                                                                                                                                                                                            | Description                             |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
| [Creating a custom schema type](https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-schema-type#post-schema-tenant-custom-entities)                        | It creates a new schema type.           |
| [Retrieving all custom schema types](https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-schema-type#get-schema-tenant-custom-entities)                    | It retrieves all custom schema types.   |
| [Retrieving a custom schema type](https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-schema-type#get-schema-tenant-custom-entities-id)                    | It retrieves a custom schema type.      |
| [Deleting a custom schema type](https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-schema-type#delete-schema-tenant-custom-entities-id)                   | It deletes a custom schema type.        |
| [Upserting a custom schema type](https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-schema-type#put-schema-tenant-custom-entities-id)                     | It upserts custom schema type.          |
| [Creating a custom instance](https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-instance#post-schema-tenant-custom-entities-type-instances)               | It creates a custom instance.           |
| [Retrieving all custom instances](https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-instance#get-schema-tenant-custom-entities-type-instances)           | It retrieves all custom instances.      |
| [Retrieving a custom instance](https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-instance#get-schema-tenant-custom-entities-type-instances-id)           | It retrieves a custom instance.         |
| [Deleting a custom instance](https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-instance#delete-schema-tenant-custom-entities-type-instances-id)          | It deletes a custom instance.           |
| [Upserting a custom instance](https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-instance#put-schema-tenant-custom-entities-type-instances-id)            | It upserts a custom instance.           |
| [Patching a custom instance](https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-instance#patch-schema-tenant-custom-entities-type-instances-id)           | It partially updates a custom instance. |
| [Searching for custom instances](https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-instance#post-schema-tenant-custom-entities-type-instances-search)    | It searches for custom instances.       |
| [Creating custom instances in bulk](https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-instance#post-schema-tenant-custom-entities-type-instances-bulk)   | It creates custom instances in bulk.    |
| [Upserting custom instances in bulk](https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-instance#put-schema-tenant-custom-entities-type-instances-bulk)   | It upserts custom instances in bulk.    |
| [Deleting custom instances in bulk](https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-instance#delete-schema-tenant-custom-entities-type-instances-bulk) | It deletes custom instances in bulk.    |

## Known problems

There are no known problems.