Documentation Powered by Redocly

Entity-Management-Service (1.0.0)

Download OpenAPI specification:Download

E-mail: tech-infra@shikshalokam.org
  • This Service enables the creation and management of various entities and entityType .It provides functionalities for entities, ensuring seamless integration and maintenance of entity-related data across the platform.

🔐 Note for Admin/System Admin:
When accessing APIs as an Admin or System Admin, include the following headers in your request:

Header Name Description Example Value
admin-auth-token Admin-specific auth token {admin-auth-token}
tenantId Tenant identifier shikshagraha
orgId Organization ID blr

userRoleExtension-API's

To create a single user role extension data

You can use this API to to create user role extension data. /v1/userRoleExtension/create

  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null
header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
required
string
admin-auth-token
string

This header should be passed when system admin wants to create resources

tenantId
string

This header specifies the tenant data of the resource creator. This header should be passed when system admin wants to create resources

orgId
string

This header specifies the organization data of the resource creator. This header should be passed when system admin wants to create resources

Request Body schema: application/json
title
string
value
string
userRoleId
string
code
string
Array of objects

Responses

Request samples

Content type
application/json
{
  • "title": " Head Master",
  • "value": "19",
  • "userRoleId": "777",
  • "code": "HH",
  • "entityTypes": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": 0,
  • "result": {
    }
}

To update a single user role extension data

You can use this API to update user role extension data by passing id in the path param. /v1/userRoleExtension/update/{_id}

  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null
header Parameters
X-auth-token
string

You require an X-auth-token to use this API. This token is available in the login API Response.

Request Body schema: application/json
title
string

Responses

Request samples

Content type
application/json
{
  • "title": "Head Master"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": 0,
  • "result": {
    }
}

Find the user role extension data.

Use this API to get the details of user role extension data based on the request body passed. /v1/userRoleExtension/find

  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null
header Parameters
X-auth-token
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
required
string
admin-auth-token
string

This header should be passed when system admin wants to create resources

tenantId
string

This header specifies the tenant data of the resource creator. This header should be passed when system admin wants to create resources

orgId
string

This header specifies the organization data of the resource creator. This header should be passed when system admin wants to create resources

Request Body schema: application/json
object
projection
Array of strings

Responses

Request samples

Content type
application/json
{
  • "query": {
    },
  • "projection": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": 0,
  • "result": [
    ],
  • "count": 0
}

Delete user role extension data.

Use this API to delete user role extension data by passing it's id. /v1/userRoleExtension/delete

  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null
header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
required
string
admin-access-token
string

This header should be passed when system admin wants to create resources

tenantId
string

This header specifies the tenant data of the resource creator. This header should be passed when system admin wants to create resources

orgId
string

This header specifies the organization data of the resource creator. This header should be passed when system admin wants to create resources

Responses

Response samples

Content type
application/json
{
  • "message": "USER_ROLE_DELETED",
  • "status": 200
}

entityType-API's

BulkCreate create entity type

This api is use to create entity types in bulk by passing a csv file which contain entity type information

  • The API Endpoint for creating entity types in bulk by passing a csv file which contain entity type information is /v1/entityType/bulkCreate
  • It is mandatory to provide values for parameters which are marked as required
  • This is a mandatory parameter and cannot be empty or null.
header Parameters
X-auth-token
required
string

To use this API, you require an X-auth-token. This token is available in the login API Response.

internal-access-token
required
string
admin-auth-token
required
string

This header should be passed when system admin wants to create resources

tenantId
required
string

This header specifies the tenant data of the resource creator. This header should be passed when system admin wants to create resources

orgId
required
string

This header specifies the organization data of the resource creator. This header should be passed when system admin wants to create resources

Request Body schema: multipart/form-data
file
string <binary>

The CSV file to upload

Responses

Response samples

Content type
text
"name",
"registry-name",
"isObservable",
"toBeMappedToParentEntities",
"immediateChildrenEntityType",
"registryDetails",
"tenantId",
"orgId",
"_SYSTEM_ID",
"status"
"blockkks",
"locationRegistry",
true,
true,
"[""school""]",
"{""name"":""locationRegistry""}",
"shikshagraha",
"orgId",
"6679320261add28f7f681294",
"SUCCESS"

BulkUpdate create entityType

You can use this API to update entityType by passing CSV file.

  • The API Endpoint for updating entityType by passing CSV file is /v1/entityTypes/bulkUpdate
  • It is mandatory to provide values for parameters which are marked as required
  • This is a mandatory parameter and cannot be empty or null.
header Parameters
X-auth-token
required
string

To use this API, you require an X-auth-token. This token is available in the login API Response.

internal-access-token
required
string
admin-auth-token
required
string

This header should be passed when system admin wants to create resources

tenantId
required
string

This header specifies the tenant data of the resource creator. This header should be passed when system admin wants to create resources

orgId
required
string

This header specifies the organization data of the resource creator. This header should be passed when system admin wants to create resources

Request Body schema: multipart/form-data
file
string <binary>

The CSV file to upload

Responses

Response samples

Content type
text
"name",
"registryname",
"isObservable",
"toBeMappedToParentEntities",
"immediateChildrenEntityType",
"tenantId",
"orgId",
"_SYSTEM_ID",
"status",
"ghj",
"locationRegistry",
true,
true,
"[""[\""school\"""",
"" “high School”
]""
]",
"shikshagraha",
"blr",
"6679320261add28f7f681294","SUCCESS",

This api will create's Single entity Type data

You can use this API to create a single entityType data.

  • The API Endpoint to create a single entityType data is /v1/entityTypes/create
  • It is mandatory to provide values for parameters which are marked as required
  • This is a mandatory parameter and cannot be empty or null.
header Parameters
X-auth-token
required
string

To use this API, you require an X-auth-token. This token is available in the login API Response.

internal-access-token
required
string
admin-auth-token
required
string

This header should be passed when system admin wants to create resources

tenantId
required
string

This header specifies the tenant data of the resource creator. This header should be passed when system admin wants to create resources

orgId
required
string

This header specifies the organization data of the resource creator. This header should be passed when system admin wants to create resources

Request Body schema: application.json
name
string
object
isObservable
boolean
toBeMappedToParentEntities
boolean

Responses

Request samples

Content type
application.json
{
  • "name": "state",
  • "registryDetails": {
    },
  • "isObservable": true,
  • "toBeMappedToParentEntities": true
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": 0,
  • "result": {
    }
}

Update single entities based on the entityType id

You can use this API to update single entities based on the entityType id .

  • The API Endpoint to update single entities based on the entityType id is /v1/entityTypes/update/{_id}
  • It is mandatory to provide values for parameters which are marked as required
  • This is a mandatory parameter and cannot be empty or null.
path Parameters
string
query Parameters
_id
required
string

The unique identifier for the data that needs to be updated. This id ensures the correct record is matched for the update operation.

header Parameters
X-auth-token
required
string

To use this API, you require an X-auth-token. This is available in the login API Response.

internal-access-token
required
string
admin-auth-token
required
string

This header should be passed when system admin wants to create resources

tenantId
required
string

This header specifies the tenant data of the resource creator. This header should be passed when system admin wants to create resources

orgId
required
string

This header specifies the organization data of the resource creator. This header should be passed when system admin wants to create resources

Request Body schema: application.json
name
string
object
isObservable
boolean
toBeMappedToParentEntities
boolean
immediateChildrenEntityType
string

Responses

Request samples

Content type
application.json
{
  • "name": "school",
  • "registryDetails": {
    },
  • "isObservable": true,
  • "toBeMappedToParentEntities": true,
  • "immediateChildrenEntityType": "collage"
}

Response samples

Content type
application/json
{
  • "status": 0,
  • "result": {
    }
}

This API can be used to list all entity types

Use this API to list all entityTypes

  • The API Endpoint to fetch all the list in entityType. /v1/entityTypes/list
  • It is mandatory to provide values for parameters which are marked as required
  • This is a mandatory parameter and cannot be empty or null.
header Parameters
X-auth-token
required
string

To use this API, you require an X-auth-token, which is available in the login API response.

Responses

Response samples

Content type
application.json
{
  • "message": "ENTITY_TYPES_FETCHED",
  • "status": 200,
  • "result": [
    ]
}

Find the entityTypes

Use this API to get the details of entityType data based on the request body passed.

  • The API Endpoint for reading the details of the entity type is /v1/entityTypes/find
  • It is mandatory to provide values for parameters which are marked as required
  • This is a mandatory parameter and cannot be empty or null.
header Parameters
X-auth-token
required
string

To use this API, you require an X-auth-token, which is available in the login API Response.

internal-access-token
required
string
Request Body schema: application/json
object
object
object

Responses

Request samples

Content type
application/json
{
  • "query": {
    },
  • "projection": {
    },
  • "skipFields": {
    }
}

Response samples

Content type
application.json
{
  • "message": "ENTITY_TYPES_FETCHED",
  • "status": 200,
  • "result": [
    ]
}

entities-API's

Bulk creation of entities

You can use this API to create bulk create entities based on type and CSV file we pass.

  • The API Endpoint for creating bulk entities based on type and CSV file we pass. /v1/entities/bulkCreate
  • It is mandatory to provide values for parameters which are marked as required
  • This is a mandatory parameter and cannot be empty or null
query Parameters
type
required
any

Please pass entity type value for the entity.

header Parameters
X-auth-token
required
string

To use this API, you require an X-auth-token. This token is available in the login API Response.

internal-access-token
required
any
admin-auth-token
string

This header should be passed when system admin wants to create resources

tenantId
string

This header specifies the tenant data of the resource creator. This header should be passed when system admin wants to create resources

orgId
string

This header specifies the organization data of the resource creator. This header should be passed when system admin wants to create resources

Request Body schema: multipart/form-data
entities
string <binary>

The CSV file to upload

translationFile
string <binary>

The JSON file to upload

Responses

Response samples

Content type
text
"Staff_id",
"externalId",
"name",
"region",
"capital",
"tenantId",
"orgId",
"_arrayFields",
"_existingKeyField",
"_SYSTEM_ID"
"",
"PBS",
"Punjab",
"North east",
"Chandigarh",
"shikshagraha",
"blr",
"",
"externalId",
"6679336f61add28f7f681298"

Bulk updates of entities

You can use this API to update entities data based on the type and entity id we pass through CSV file that contain information to update.

  • The API Endpoint for updating entities by passing csv file /v1/entities/bulkUpdate
  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null
header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
required
string
content-type
required
string
admin-auth-token
string

This header should be passed when system admin wants to create resources

tenantId
string

This header specifies the tenant data of the resource creator. This header should be passed when system admin wants to create resources

orgId
string

This header specifies the organization data of the resource creator. This header should be passed when system admin wants to create resources

Request Body schema: multipart/form-data
entities
string <binary>

The CSV file to upload

translationFile
string <binary>

The JSON file to upload

Responses

Response samples

Content type
text
"externalId",
"name",
"region",
"capital",
"_arrayFields",
"_existingKeyField",
"tenantId",
"orgId",
"_SYSTEM_ID",
"UPDATE_STATUS"
"entity506",
"bijapur",
"North east",
"Chandigarh",
"",
"externalId",
"shikshagraha",
"blr",
"6679336f61add28f7f681298",
"SUCCESS"

Add single entities

The API is used to create single entities based on entityType

  • The API Endpoint to create single entities creation based on type /v1/entities/add
  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null.
path Parameters
type
required
string
Example: 1

Please pass entity type value for the entity.

header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
required
string
admin-auth-token
string

This header should be passed when system admin wants to create resources

tenantId
string

This header specifies the tenant data of the resource creator. This header should be passed when system admin wants to create resources

orgId
string

This header specifies the organization data of the resource creator. This header should be passed when system admin wants to create resources

Request Body schema: application/json
externalId
string
name
string
childHierarchyPath
Array of strings
targetedEntityTypes
Array of strings

Responses

Request samples

Content type
application/json
{
  • "externalId": "KA28",
  • "name": "Karnataka",
  • "childHierarchyPath": [
    ],
  • "targetedEntityTypes": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": 0,
  • "result": [
    ]
}

Provide details of an entity based on the entity id. This API returns the details of a single entity at a time.

You can use this API to get details based on entity id or externalId.

  • The API to get details of an entities based on entity id: /v1/entities/details
  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null.
path Parameters
_id
required
string
Example: 1

Please append a valid entity id or externalId to the Request URL.

Responses

Response samples

Content type
application/json
{
  • "message": "ENTITY_INFORMATION_FETCHED",
  • "status": 200,
  • "result": [
    ]
}

Update an entity

You can use this API to update the entity data based on entiy id.

  • The API Endpoint to update single entities : /v1/entities/update/{_id}
  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null.
path Parameters
_id
required
string
Example: 1

Please append a valid entities Id to the Request URL.

header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API., which is available in the login API Response.

internal-access-token
required
string
admin-auth-token
string

This header should be passed when system admin wants to create resources

tenantId
string

This header specifies the tenant data of the resource creator. This header should be passed when system admin wants to create resources

orgId
string

This header specifies the organization data of the resource creator. This header should be passed when system admin wants to create resources

Request Body schema: application/json
Array of objects
metaInformation.name
string
childHierarchyPath
Array of strings

Responses

Request samples

Content type
application/json
{
  • "metaInformation.targetedEntityTypes": [
    ],
  • "metaInformation.name": "Karnataka ",
  • "childHierarchyPath": [ ]
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": 0,
  • "result": {
    }
}

This endpoint will map its childEntity to its parentEntity

You can use this API to map the childEntity to parentEntity

  • The API Endpoint will map its childEntity to its parentEntity /v1/entities/mappingUpload
  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null.
header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
required
any
Request Body schema: multipart/form-data
file
string <binary>

The CSV file to upload

Responses

Response samples

Content type
application.json
{
  • "message": "ENTITY_INFORMATION_UPDATE",
  • "status": 200,
  • "result": {
    }
}

This endpoint will create mapping CSV .

You can use this API to create a mapping CSV

  • The API Endpoint will generate a mapping CSV /v1/entities/createMappingCsv
  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null.
header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
required
any
admin-auth-token
required
string

This header should be passed when system admin wants to create resources

tenantId
required
string

This header specifies the tenant data of the resource creator. This header should be passed when system admin wants to create resources

orgId
required
string

This header specifies the organization data of the resource creator. This header should be passed when system admin wants to create resources

Request Body schema: multipart/form-data
file
string <binary>

The CSV file to upload

Responses

Response samples

Content type
application.json
{
  • "message": "MAPPING_CSV_GENERATED",
  • "status": 200,
  • "result": {
    }
}

You can use this API to list entity based on id.

You can use this API to list entities based on its type

  • The API Endpoint to list entities based on its type: v1/entities/listByEntityType/_id
  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null.
path Parameters
_id
required
string
Example: 1

Please append a valid entity id to the Request URL.

page
number
Example: 1

Please append number for pagination.

limit
number
Example: 2

number of record to limit

header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
required
any

Responses

Response samples

Content type
application/json
{
  • "message": "ASSETS_FETCHED_SUCCESSFULLY",
  • "status": 200,
  • "result": [
    ]
}

Find the entities based on queries

You can use this API to find entities based on query.

  • The API Endpoint for finding entities based on query: /v1/entities/find
  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null.
query Parameters
page
number

Page number for pagination

limit
number

Number of documents to return per page

search
string

Optional search string for text-based filtering

aggregateValue
string

Field path to be used for aggregation

aggregateStaging
boolean

Whether to apply aggregation stages in the pipeline

aggregateSort
boolean

Whether to apply sorting within the aggregation pipeline

header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
required
any
Request Body schema: application.json
object
projection
Array of strings

Responses

Request samples

Content type
application.json
{
  • "query": {
    },
  • "projection": [
    ]
}

Response samples

Content type
application.json
{
  • "message": "ASSETS_FETCHED_SUCCESSFULLY",
  • "status": 200,
  • "result": [
    ]
}

List entities based on entity id

You can use this API to list the entities based on entity id and entity Type

  • The API Endpoint for listing the entities based on entity id and entity Type: /v1/entities/list
  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null.
path Parameters
_id
required
string
Example: 1

Please append a valid entitie Id to the Request URL.

page
any
limit
any
type
required
any

Please pass entity type value for the entity

header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
required
any

Responses

Response samples

Content type
application.json
{
  • "status": 200,
  • "result": {
    }
}

Get related entities based on entity id

You can use this API to get the realted entities data based on entity id

  • The API Endpoint to get the related entities data based on entity id: /v1/entities/relatedEntities
  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null.
path Parameters
_id
required
string
Example: 1

Please append a valid entity Id to the Request URL.

header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
required
string

Responses

Response samples

Content type
application.json
{
  • "message": "ENTITY_FETCHED",
  • "status": 200,
  • "result": {
    }
}

List the entities based on location id

You can use this API to get entities based on locations Id

  • Endpoint to get entities based on locations Id /v1/entities/listByLocationIds
  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null
header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
string
Request Body schema: application/json
locationIds
Array of strings

Responses

Request samples

Content type
application/json
{
  • "locationIds": [
    ]
}

Response samples

Content type
application.json
{
  • "message": "ENTITY_FETCHED",
  • "status": 200,
  • "result": [
    ]
}

List all the entities based on location id

You can use this API to list entity based on location id *Endpoint to list entity based on location id /v1/entities/subEntityListBasedOnRoleAndLocation

  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null
path Parameters
_id
required
string
Example: 1

Please append a valid entity Id To the Request URL

header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
string

Responses

Response samples

Content type
application.json
{
  • "message": "ENTITIES_CHILD_HIERACHY_PATH",
  • "status": 200,
  • "result": [
    ]
}

Will provide the sub entity based on types

This API will help to get entities based on parent id and entity type we pass. This API will help to get entities based on parent id and entity type we pass. * It is mandatory to provide values for parameters marked with required

  • Mandatory parameter cannot be empty or null
path Parameters
page
number
Example: 1

Please add page number

limit
number
Example: 2

number of record to limit

type
string

Please pass entity type value for the entity

search
string
_id
required
string

Please append a valid entity id

query Parameters
parentInfoRequired
any

Pass this paramater as true if need parents details

header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
required
string

Responses

Response samples

Content type
application.json
{
  • "status": 200,
  • "result": {
    }
}

List the entities based on entity id

This API will help to list the entities based on entity id

  • The API Endpoint to list the entities based on entity id /v1/entities/listByIds
  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null
header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
string
Request Body schema: application/json
entities
Array of strings
fields
Array of strings

Responses

Request samples

Content type
application/json
{
  • "entities": [
    ],
  • "fields": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "ENTITIES_FETCHED",
  • "status": 200,
  • "result": [
    ]
}

List all the entities based on entity type.

You can use this API to list entity based on entity type *Endpoint to list entity based on entity type /v1/entities/entityListBasedOnEntityType?entityType={entity_Type}

  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null
path Parameters
entityType
required
string
Example: 1

Please pass entity type value for the entity.

header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
string

Responses

Response samples

Content type
application.json
{
  • "message": "ASSETS_FETCHED_SUCCESSFULLY",
  • "status": 200,
  • "result": [
    ]
}

Fetch Targeted Roles

You can use this API to fetch targeted roles based on the provided entity id in the request parameters. *Endpoint to fetch targeted roles based on the provided entity id /v1/entities/targetedRoles?{entity_id}

  • It is mandatory to provide values for parameters marked with required
  • Mandatory parameter cannot be empty or null
path Parameters
entity_id
required
string

Please append a valid entity Id to the Request URL.

query Parameters
entityType
required
string

Please append a valid entity type to retrieve the roles associated with its higher-level entity types.

paginate
string

The data will be paginated and that will include count as well

roleLevel
string

Role level to filter roles

header Parameters
X-auth-token
string

You require an X-auth-token to use this API. This token is available in the login API Response.

Responses

Response samples

Content type
application.json
{
  • "message": "ROLES_FETCHED_SUCCESSFULLY",
  • "status": 200,
  • "result": {
    }
}

Admin-API's

Find the user role extension data.

This endpoint allows an admin to create an index for a specificollection. The request body should include the keys to be indexed.

  • The endpoint allows a user to create an index for a specified collection. The request body should include the keys to be indexed is /v1/admin/createIndex.
  • It is mandatory to provide values for parameters which are marked as required
  • This is a mandatory parameter and cannot be empty or null.
header Parameters
X-auth-token
required
string

You require an X-auth-token to use this API. This token is available in the login API Response.

internal-access-token
required
string

You require an internal-access-token to use this API.

collection_name
required
string

We need to pass valid collectionName to create an index for a specified collection.

Request Body schema: application/json
keys
Array of strings

Responses

Request samples

Content type
application/json
{
  • "keys": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "KEYS_INDEXED_SUCCESSFULL",
  • "status": 200
}

Delete Entities Data

This endpoint allows an admin to delete the Entities and its child Entities

  • The endpoint allows a user to delete the Entities and its child Entities is /v1/admin/deleteEntity.
  • It is mandatory to provide values for parameters which are marked as required
  • This is a mandatory parameter and cannot be empty or null.
path Parameters
_id
required
string

Valid Entities Id to be passed

allowRecursiveDelete
boolean
header Parameters
x-auth-token
required
string

To use this API, you require an X-auth-token. This is available in the login API Response.

internal-access-token
required
string

internal-access-token

admin-auth-token
required
string

admin-auth-token

tenantId
required
string

tenantId

orgId
required
string

orgId

Responses

Response samples

Content type
application/json
{
  • "message": "ENTITIES_DELETED_SUCCESSFULLY",
  • "status": 200,
  • "result": {
    }
}

healthCheck-API

This endpoint is used to verify the health status

This endpoint is used to verify the health status of the Entity Service and its dependencies.

  • The API Endpoint for health check is is /entity-management/health.
  • It is mandatory to provide values for parameters which are marked as required
  • This is a mandatory parameter and cannot be empty or null.

Responses

Response samples

Content type
application/json
{
  • "id": "service.health.api",
  • "ver": "1.0",
  • "ts": "2025-07-18T04:34:56.113Z",
  • "params": {
    },
  • "status": 200,
  • "result": {
    }
}