Department

Gets a list of departments

get

This endpoint is used to fetch all the department in the current organization

Authorizations

Query parameters

items_per_pageintegerRequired

Items Per Page

pageintegerRequired

Page Number

reversebooleanOptional

Sorting Order

sortstringOptional

Sorting Key

Responses

200Success

application/json

get

HTTPcURLJavaScriptPython

GET /ux/common/department/department/?items_per_page=1&page=1 HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200Success

[
  {
    "id": "text",
    "name": "text",
    "ci_display_name": "text",
    "ci_descr": "text",
    "dept_id": "text",
    "organization": "text",
    "dept_name": "text",
    "dept_head": "text",
    "prime_user": [],
    "description": "text",
    "created_by": 1,
    "modified_by": 1,
    "creation_time": "2025-06-07T11:51:33.822Z",
    "last_update_time": "2025-06-07T11:51:33.822Z",
    "is_deleted": true,
    "is_demo_data": true
  }
]

Creates a new department

post

This endpoint is used to save a new department for the current organization

Authorizations

Body

Other propertiesanyOptional

Responses

201

No response body

post

HTTPcURLJavaScriptPython

POST /ux/common/department/department/ HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 107

{
  "dept_name": "Finance Department",
  "dept_head": [
    "Ramesh"
  ],
  "description": "Finance",
  "prime_user": [
    "Akshatha"
  ]
}

201

No response body

No content

Gets a department with the given id

get

This endpoint is used to fetch a department details in the current organization

Authorizations

Path parameters

idstringRequired

Responses

200Success

application/json

get

HTTPcURLJavaScriptPython

GET /ux/common/department/department/{id}/ HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200Success

{
  "id": "text",
  "name": "text",
  "ci_display_name": "text",
  "ci_descr": "text",
  "dept_id": "text",
  "organization": "text",
  "dept_name": "text",
  "dept_head": "text",
  "prime_user": [],
  "description": "text",
  "created_by": 1,
  "modified_by": 1,
  "creation_time": "2025-06-07T11:51:33.822Z",
  "last_update_time": "2025-06-07T11:51:33.822Z",
  "is_deleted": true,
  "is_demo_data": true
}

Edits the department with given id

put

This endpoint is used to edit an existing department for the current organization

Authorizations

Path parameters

idstringRequired

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

Serializer for Documents.

Recognized primitve fields:

* ``StringField``
* ``URLField``
* ``EmailField``
* ``IntField``
* ``LongField``
* ``FloatField``
* ``DecimalField``
* ``BooleanField``
* ``DateTimeField``
* ``ComplexDateTimeField``
* ``ObjectIdField``
* ``SequenceField`` (assumes it has integer counter)
* ``UUIDField``
* ``GeoPointField``
* ``GeoJsonBaseField`` (all those fields)
* ``DateField``

Compound fields: ListField and DictField are mapped to corresponding DRF fields, with respect to nested field specification.

The ReferenceField is handled like ForeignKey in DRF: there nested serializer autogenerated if serializer depth greater then 0, otherwise it's handled by it's own (results as str(id)).

For EmbeddedDocumentField also nested serializer autogenerated for non-zero depth, otherwise it is skipped. TODO: THIS IS PROBABLY WRONG AND SHOULD BE FIXED.

Generic fields GenericReferenceField and GenericEmbeddedDocumentField are handled by their own with corresponding serializer fields.

Not well supported or untested:

``FileField``
``ImageField``
``BinaryField``

All other fields are mapped to DocumentField and probably will work wrong.

idstringRead-onlyRequired

namestringRequired

ci_display_namestringRequired

ci_descrstringRequired

dept_idstring · max: 25Required

organizationstring · max: 25Required

dept_namestringOptional

dept_headstringOptional

descriptionstringOptional

created_byintegerOptional

modified_byintegerOptional

creation_timestring · date-timeOptional

last_update_timestring · date-timeOptional

is_deletedbooleanOptional

is_demo_databooleanOptional

Responses

200Success

application/json

put

HTTPcURLJavaScriptPython

PUT /ux/common/department/department/{id}/ HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 330

{
  "name": "text",
  "ci_display_name": "text",
  "ci_descr": "text",
  "dept_id": "text",
  "organization": "text",
  "dept_name": "text",
  "dept_head": "text",
  "prime_user": [],
  "description": "text",
  "created_by": 1,
  "modified_by": 1,
  "creation_time": "2025-06-07T11:51:33.822Z",
  "last_update_time": "2025-06-07T11:51:33.822Z",
  "is_deleted": true,
  "is_demo_data": true
}

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

200Success

{
  "id": "text",
  "name": "text",
  "ci_display_name": "text",
  "ci_descr": "text",
  "dept_id": "text",
  "organization": "text",
  "dept_name": "text",
  "dept_head": "text",
  "prime_user": [],
  "description": "text",
  "created_by": 1,
  "modified_by": 1,
  "creation_time": "2025-06-07T11:51:33.822Z",
  "last_update_time": "2025-06-07T11:51:33.822Z",
  "is_deleted": true,
  "is_demo_data": true
}

Deletes the department with given id

delete

This endpoint is used to delete an existing department for the current organization

Authorizations

Path parameters

idstringRequired

Responses

204

No response body

delete

HTTPcURLJavaScriptPython

DELETE /ux/common/department/department/{id}/ HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

204

No response body

No content

post

API endpoint that allows users to be viewed or edited.

Authorizations

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

Serializer for Documents.

Recognized primitve fields:

* ``StringField``
* ``URLField``
* ``EmailField``
* ``IntField``
* ``LongField``
* ``FloatField``
* ``DecimalField``
* ``BooleanField``
* ``DateTimeField``
* ``ComplexDateTimeField``
* ``ObjectIdField``
* ``SequenceField`` (assumes it has integer counter)
* ``UUIDField``
* ``GeoPointField``
* ``GeoJsonBaseField`` (all those fields)
* ``DateField``

Compound fields: ListField and DictField are mapped to corresponding DRF fields, with respect to nested field specification.

The ReferenceField is handled like ForeignKey in DRF: there nested serializer autogenerated if serializer depth greater then 0, otherwise it's handled by it's own (results as str(id)).

For EmbeddedDocumentField also nested serializer autogenerated for non-zero depth, otherwise it is skipped. TODO: THIS IS PROBABLY WRONG AND SHOULD BE FIXED.

Generic fields GenericReferenceField and GenericEmbeddedDocumentField are handled by their own with corresponding serializer fields.

Not well supported or untested:

``FileField``
``ImageField``
``BinaryField``

All other fields are mapped to DocumentField and probably will work wrong.

idstringRead-onlyRequired

namestringRequired

ci_display_namestringRequired

ci_descrstringRequired

dept_idstring · max: 25Required

organizationstring · max: 25Required

dept_namestringOptional

dept_headstringOptional

descriptionstringOptional

created_byintegerOptional

modified_byintegerOptional

creation_timestring · date-timeOptional

last_update_timestring · date-timeOptional

is_deletedbooleanOptional

is_demo_databooleanOptional

Responses

200Success

application/json

post

HTTPcURLJavaScriptPython

POST /ux/common/department/department/multidelete/ HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 330

{
  "name": "text",
  "ci_display_name": "text",
  "ci_descr": "text",
  "dept_id": "text",
  "organization": "text",
  "dept_name": "text",
  "dept_head": "text",
  "prime_user": [],
  "description": "text",
  "created_by": 1,
  "modified_by": 1,
  "creation_time": "2025-06-07T11:51:33.822Z",
  "last_update_time": "2025-06-07T11:51:33.822Z",
  "is_deleted": true,
  "is_demo_data": true
}

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

200Success

{
  "id": "text",
  "name": "text",
  "ci_display_name": "text",
  "ci_descr": "text",
  "dept_id": "text",
  "organization": "text",
  "dept_name": "text",
  "dept_head": "text",
  "prime_user": [],
  "description": "text",
  "created_by": 1,
  "modified_by": 1,
  "creation_time": "2025-06-07T11:51:33.822Z",
  "last_update_time": "2025-06-07T11:51:33.822Z",
  "is_deleted": true,
  "is_demo_data": true
}

get

API endpoint that allows users to be viewed or edited.

Authorizations

Responses

200Success

application/json

get

HTTPcURLJavaScriptPython

GET /ux/common/department/department/options/ HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200Success

{
  "id": "text",
  "name": "text",
  "ci_display_name": "text",
  "ci_descr": "text",
  "dept_id": "text",
  "organization": "text",
  "dept_name": "text",
  "dept_head": "text",
  "prime_user": [],
  "description": "text",
  "created_by": 1,
  "modified_by": 1,
  "creation_time": "2025-06-07T11:51:33.822Z",
  "last_update_time": "2025-06-07T11:51:33.822Z",
  "is_deleted": true,
  "is_demo_data": true
}