---
title: "Asset type scheme REST services"
canonical: "https://support.appfire.com/space/AIP/10256562/Asset%20type%20scheme%20REST%20services"
format: markdown
---
> Macro (aura-html)

This guide details the REST API functionalities for managing asset type schemes within the Assets & Inventory Plugin.

## Listing all asset type schemes

| **Method** | GET |
| --- | --- |
| **URL** | /rest/jip-api/1.0/schema/objectSchemas.json |

<details>
<summary>Sample response:</summary>

```
{
  "success" : true,
  "errorCode" : null,
  "errorMessage" : null,
  "data" : [ {
    "created" : 1587720396812,
    "createdBy" : "system",
    "updated" : 1587720396812,
    "updatedBy" : "system",
    "id" : 1,
    "schemaName" : "Default Asset Scheme",
    "key" : null,
    "description" : "Auto generated default Asset Types Scheme (system)",
    "forms" : [ ]
  }, {
    "created" : 1587725435018,
    "createdBy" : "admin",
    "updated" : 1587727019075,
    "updatedBy" : "admin",
    "id" : 2,
    "schemaName" : "Snapbytes Inventory",
    "key" : null,
    "description" : null,
    "forms" : [ {
      "id" : 11,
      "formName" : "Server",
      "sortOrder" : 0,
      "objectSchemaId" : 2,
      "objectSchemaName" : "Snapbytes Inventory",
      "cloneFromId" : null
    }, {
      "id" : 10,
      "formName" : "Pen",
      "sortOrder" : 0,
      "objectSchemaId" : 2,
      "objectSchemaName" : "Snapbytes Inventory",
      "cloneFromId" : null
    }, {
      "id" : 7,
      "formName" : "Employee",
      "sortOrder" : 0,
      "objectSchemaId" : 2,
      "objectSchemaName" : "Snapbytes Inventory",
      "cloneFromId" : null
    }, {
      "id" : 6,
      "formName" : "Chair",
      "sortOrder" : 0,
      "objectSchemaId" : 2,
      "objectSchemaName" : "Snapbytes Inventory",
      "cloneFromId" : null
    }, {
      "id" : 5,
      "formName" : "Desk",
      "sortOrder" : 0,
      "objectSchemaId" : 2,
      "objectSchemaName" : "Snapbytes Inventory",
      "cloneFromId" : null
    }, {
      "id" : 4,
      "formName" : "Monitor",
      "sortOrder" : 0,
      "objectSchemaId" : 2,
      "objectSchemaName" : "Snapbytes Inventory",
      "cloneFromId" : null
    }, {
      "id" : 3,
      "formName" : "Keyboard",
      "sortOrder" : 0,
      "objectSchemaId" : 2,
      "objectSchemaName" : "Snapbytes Inventory",
      "cloneFromId" : null
    }, {
      "id" : 2,
      "formName" : "Mouse",
      "sortOrder" : 0,
      "objectSchemaId" : 2,
      "objectSchemaName" : "Snapbytes Inventory",
      "cloneFromId" : null
    }, {
      "id" : 1,
      "formName" : "Computer",
      "sortOrder" : 0,
      "objectSchemaId" : 2,
      "objectSchemaName" : "Snapbytes Inventory",
      "cloneFromId" : null
    } ]
  } ],
  "pagingInfo" : null
}
```
</details>

## Create asset type scheme

> ✅ **Important:**
> ✅ 
> ✅ - While creating and updating asset type schemes with REST APIs, `"schemaName"` variable must be defined in the request body. Otherwise, you will not be able to create or update asset type schemes.
> ✅ - Variables that are not defined in the request body will be considered as null.

| **Method** | POST |
| --- | --- |
| **URL** | /rest/jip-api/1.0/schema/objectSchema.json |

<details>
<summary>Request body:</summary>

```
{
  "schemaName": "Example asset type scheme",
  "description": "This is an example asset type scheme"
}
```
</details>

<details>
<summary>Sample response:</summary>

```
{
  "success" : true,
  "errorCode" : null,
  "errorMessage" : null,
  "data" : {
    "created" : 1589374230209,
    "createdBy" : "admin",
    "updated" : 1589374230209,
    "updatedBy" : "admin",
    "id" : 3,
    "schemaName" : "Example asset type scheme",
    "key" : null,
    "description" : "This is an example asset type scheme",
    "forms" : [ ]
  },
  "pagingInfo" : null
}
```
</details>

<details>
<summary>Failure message:</summary>

```
{
  "success": false,
  "errorCode": "EntityExistsException",
  "errorMessage": "Example asset type scheme",
  "data": null,
  "pagingInfo": null
}
```
</details>

## Update asset type scheme

| **Method** | POST |
| --- | --- |
| **URL** | /rest/jip-api/1.0/schema/objectSchema.json |

<details>
<summary>Request body:</summary>

```
{
  "id": 3,
  "schemaName": "Example asset type scheme edit",
  "key": null,
  "description": "This is an example asset type scheme",
  "forms": []
}
```
</details>

<details>
<summary>Sample response:</summary>

```
{
  "success": true,
  "errorCode": null,
  "errorMessage": null,
  "data": {
    "created": 1589374230209,
    "createdBy": "admin",
    "updated": 1589374439770,
    "updatedBy": "admin",
    "id": 3,
    "schemaName": "Example asset type scheme edit",
    "key": null,
    "description": "This is an example asset type scheme",
    "forms": []
  },
  "pagingInfo": null
}
```
</details>

<details>
<summary>Failure message:</summary>

```
{
  "success": false,
  "errorCode": "EntityExistsException",
  "errorMessage": "Example asset type scheme edit",
  "data": null,
  "pagingInfo": null
}
```
</details>

## Delete asset type scheme

| **Method** | DELETE |
| --- | --- |
| **URL** | /rest/jip-api/1.0/schema/objectSchema/[assetTypeId].json |

<details>
<summary>Sample response:</summary>

```
{
  "success" : true,
  "errorCode" : null,
  "errorMessage" : null,
  "data" : "",
  "pagingInfo" : null
}
```
</details>

<details>
<summary>Failure message:</summary>

```
{
  "success": false,
  "errorCode": "EntityNotFoundException",
  "errorMessage": "55",
  "data": null,
  "pagingInfo": null
}
```
</details>