Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Status
colourGreen
title3.18.01
 
Status
colourYellow
title4.6.0

The Entity REST API is used to create a new entity for ServiceMobility.

Note

This API is only accessible with a valid super user JWT.



Panel
borderColorgrey
bgColorwhitesmoke

On this page:

Table of Contents
maxLevel1

Related pages:


Resource URL

Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

Get the details of an existing Entity

GET /saas/v3/Entity/${EntityID}

Create a new Entity

POST /saas/v3/Entity

Create a new Entity

PUT /saas/v3/Entity/${EntityID}

Delete an existing Entity

DELETE /saas/v3/Entity/${EntityID}

API Specific Parameters

ParameterDescription

${EntityId}

The identifier for the entity to be obtained, created, or deleted.

Include Page
_Default HTTP Headers
_Default HTTP Headers



API Specifics


Panel
borderColor#D3D3D3

Get the details of an existing Entity

Get the details of an existing ServiceMobility entity. The specified Entity ID must exist.

URL

Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

GET /saas/v3/Entity/${EntityID}

HTTP Request Body

This request does not require a request body.

HTTP Response Body

On success, an HTTP response code of 200 will be returned, and the body will contain an REST Object Definitions Configuration Related Objects Entity Object.

Otherwise, the response body will contains details regarding the error.


Panel
borderColor#D3D3D3

Create a new Entity

Create a new ServiceMobility entity. The system will automatically assign an Entity ID for the object.

URL

Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

POST /saas/v3/Entity

HTTP Request Body

The HTTP request body must contain a valid REST Object Definitions Configuration Related Objects Entity Object.

HTTP Response Body

On success, an HTTP response code of 201 will be returned, and the URL of the newly created entity will be returned in the standard HTTP response headers.

Otherwise, the response body will contains details regarding the reason why the entity was not created.


Panel
borderColor#D3D3D3

Create a new Entity

Create a new ServiceMobility entity. The specified Entity ID must not exist.

URL

Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

PUT /saas/v3/Entity/${EntityID}

HTTP Request Body

The HTTP request body must contain a valid REST Object Definitions Configuration Related Objects Entity Object.

HTTP Response Body

On success, an HTTP response code of 200 will be returned, and the body will contain the ID of the newly created entity.

Otherwise, the response body will contains details regarding the reason why the entity was not created.


Panel
borderColor#D3D3D3

Delete an existing Entity

Delete an existing ServiceMobility entity. The specified Entity ID must exist.

URL

Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

DELETE /saas/v3/Entity/${EntityID}

HTTP Request Body

This request does not require a request body.

HTTP Response Body

On success an HTTP response code of 200 will be returned. The system will return HTTP response code 410 in case of non-existent REST Object Definitions Configuration Related Objects Entity Object.