🏭 Assets

Company asset tracking and management

List assets

get

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{org_uid}/assets/

Get a paginated list of assets with optional filters

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

org_uidstringRequired

Query parameters

asset_typestringOptional

Filter assets by asset type

assigned_tostringOptional

Filter assets by assigned person unique_id

categorystringOptional

Filter assets by category

conditionstringOptional

Filter assets by condition

namestringOptional

Filter assets by name (case-insensitive partial match)

searchstringOptional

Search assets by name, asset code, or serial number

statusstringOptional

Filter assets by status (active, inactive, disposed, etc.)

Responses

200Success

application/json

401

Unauthorized

403

Forbidden

get

/api/v1.0/organisation/{org_uid}/assets/

HTTPcURLJavaScriptPython

GET /api/v1.0/organisation/{org_uid}/assets/ HTTP/1.1
Host: skhokho.ai
Accept: */*

[
  {
    "unique_id": "text",
    "name": "text",
    "asset_code": "text",
    "serial_number": "text",
    "asset_type": "ppe",
    "category": "text",
    "brand": "text",
    "model": "text",
    "purchase_price": "text",
    "purchase_date": "2026-02-18",
    "status": "active",
    "condition": "excellent",
    "location": "text",
    "assigned_to": {
      "unique_id": "text",
      "full_name": "text"
    },
    "image_url": "text",
    "is_warranty_expired": true,
    "date_created": "2026-02-18T03:18:06.270Z"
  }
]

Create asset

post

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{org_uid}/assets/create/

Create a new asset

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

org_uidstringRequired

Body

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

Full serializer for Asset creation and updates. Handles translatable fields correctly.

namestring · min: 1 · max: 300Required

descriptionstring · nullableOptional

asset_codestring · max: 100 · nullableOptional

serial_numberstring · max: 200 · nullableOptional

asset_typestring · enumRequired

Asset type is required.

• ppe - Property, Plant & Equipment
• equipment - Equipment
• furniture - Furniture & Fixtures
• vehicle - Vehicle
• computer - Computer & IT Equipment
• software - Software
• building - Building
• land - Land
• intangible - Intangible Asset
• other - Other

Possible values:

categorystring · max: 200 · nullableOptional

brandstring · max: 200 · nullableOptional

modelstring · max: 200 · nullableOptional

purchase_pricestring · decimalRequired

Purchase price is required and must be non-negative.

Pattern: ^-?\d{0,13}(?:\.\d{0,2})?$

useful_life_yearsinteger · min: 1 · max: 100Optional

Expected useful life in years

purchase_datestring · dateRequired

Purchase date is required.

warranty_expiry_datestring · date · nullableOptional

disposal_datestring · date · nullableOptional

statusstring · enumOptional

• active - Active
• inactive - Inactive
• disposed - Disposed
• sold - Sold
• damaged - Damaged
• under_repair - Under Repair
• stolen - Stolen

Possible values:

conditionstring · enumOptional

• excellent - Excellent
• good - Good
• fair - Fair
• poor - Poor
• damaged - Damaged

Possible values:

locationstring · max: 300 · nullableOptional

assigned_to_idstring · min: 1 · nullableWrite-onlyOptional

Unique ID of person to assign asset to

imagestring · binary · nullableOptional

Asset image for identification

receipt_documentstring · binary · nullableOptional

Upload receipt, invoice, or purchase document (PDF, DOC, DOCX, JPG, PNG)

supplier_namestring · max: 300 · nullableOptional

purchase_order_numberstring · max: 100 · nullableOptional

invoice_numberstring · max: 100 · nullableOptional

Responses

201Success

application/json

400

Bad Request

401

Unauthorized

403

Forbidden

post

/api/v1.0/organisation/{org_uid}/assets/create/

HTTPcURLJavaScriptPython

POST /api/v1.0/organisation/{org_uid}/assets/create/ HTTP/1.1
Host: skhokho.ai
Content-Type: application/json
Accept: */*
Content-Length: 493

{
  "name": "text",
  "description": "text",
  "asset_code": "text",
  "serial_number": "text",
  "asset_type": "ppe",
  "category": "text",
  "brand": "text",
  "model": "text",
  "purchase_price": "text",
  "useful_life_years": 1,
  "purchase_date": "2026-02-18",
  "warranty_expiry_date": "2026-02-18",
  "disposal_date": "2026-02-18",
  "status": "active",
  "condition": "excellent",
  "location": "text",
  "assigned_to_id": "text",
  "image": "binary",
  "receipt_document": "binary",
  "supplier_name": "text",
  "purchase_order_number": "text",
  "invoice_number": "text"
}

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

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "asset_code": "text",
  "serial_number": "text",
  "asset_type": "ppe",
  "category": "text",
  "brand": "text",
  "model": "text",
  "purchase_price": "text",
  "useful_life_years": 1,
  "purchase_date": "2026-02-18",
  "warranty_expiry_date": "2026-02-18",
  "disposal_date": "2026-02-18",
  "status": "active",
  "condition": "excellent",
  "location": "text",
  "assigned_to": {
    "unique_id": "text",
    "full_name": "text"
  },
  "image_url": "text",
  "receipt_document_url": "text",
  "supplier_name": "text",
  "purchase_order_number": "text",
  "invoice_number": "text",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "is_warranty_expired": true,
  "years_since_purchase": 1,
  "date_created": "2026-02-18T03:18:06.270Z",
  "last_updated": "2026-02-18T03:18:06.270Z"
}

Retrieve asset

get

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{org_uid}/assets/{unique_id}/

Get detailed information about a specific asset

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

org_uidstringRequired

unique_idstringRequired

Responses

200Success

application/json

401

Unauthorized

403

Forbidden

404

Not Found

get

/api/v1.0/organisation/{org_uid}/assets/{unique_id}/

HTTPcURLJavaScriptPython

GET /api/v1.0/organisation/{org_uid}/assets/{unique_id}/ HTTP/1.1
Host: skhokho.ai
Accept: */*

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "asset_code": "text",
  "serial_number": "text",
  "asset_type": "ppe",
  "category": "text",
  "brand": "text",
  "model": "text",
  "purchase_price": "text",
  "useful_life_years": 1,
  "purchase_date": "2026-02-18",
  "warranty_expiry_date": "2026-02-18",
  "disposal_date": "2026-02-18",
  "status": "active",
  "condition": "excellent",
  "location": "text",
  "assigned_to": {
    "unique_id": "text",
    "full_name": "text"
  },
  "image_url": "text",
  "receipt_document_url": "text",
  "supplier_name": "text",
  "purchase_order_number": "text",
  "invoice_number": "text",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "is_warranty_expired": true,
  "years_since_purchase": 1,
  "date_created": "2026-02-18T03:18:06.270Z",
  "last_updated": "2026-02-18T03:18:06.270Z"
}

Update asset

put

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{org_uid}/assets/{unique_id}/update/

Update asset information (PUT for full update, PATCH for partial)

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

org_uidstringRequired

unique_idstringRequired

Body

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

Full serializer for Asset creation and updates. Handles translatable fields correctly.

namestring · min: 1 · max: 300Required

descriptionstring · nullableOptional

asset_codestring · max: 100 · nullableOptional

serial_numberstring · max: 200 · nullableOptional

asset_typestring · enumRequired

Asset type is required.

• ppe - Property, Plant & Equipment
• equipment - Equipment
• furniture - Furniture & Fixtures
• vehicle - Vehicle
• computer - Computer & IT Equipment
• software - Software
• building - Building
• land - Land
• intangible - Intangible Asset
• other - Other

Possible values:

categorystring · max: 200 · nullableOptional

brandstring · max: 200 · nullableOptional

modelstring · max: 200 · nullableOptional

purchase_pricestring · decimalRequired

Purchase price is required and must be non-negative.

Pattern: ^-?\d{0,13}(?:\.\d{0,2})?$

useful_life_yearsinteger · min: 1 · max: 100Optional

Expected useful life in years

purchase_datestring · dateRequired

Purchase date is required.

warranty_expiry_datestring · date · nullableOptional

disposal_datestring · date · nullableOptional

statusstring · enumOptional

• active - Active
• inactive - Inactive
• disposed - Disposed
• sold - Sold
• damaged - Damaged
• under_repair - Under Repair
• stolen - Stolen

Possible values:

conditionstring · enumOptional

• excellent - Excellent
• good - Good
• fair - Fair
• poor - Poor
• damaged - Damaged

Possible values:

locationstring · max: 300 · nullableOptional

assigned_to_idstring · min: 1 · nullableWrite-onlyOptional

Unique ID of person to assign asset to

imagestring · binary · nullableOptional

Asset image for identification

receipt_documentstring · binary · nullableOptional

Upload receipt, invoice, or purchase document (PDF, DOC, DOCX, JPG, PNG)

supplier_namestring · max: 300 · nullableOptional

purchase_order_numberstring · max: 100 · nullableOptional

invoice_numberstring · max: 100 · nullableOptional

Responses

200Success

application/json

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

put

/api/v1.0/organisation/{org_uid}/assets/{unique_id}/update/

HTTPcURLJavaScriptPython

PUT /api/v1.0/organisation/{org_uid}/assets/{unique_id}/update/ HTTP/1.1
Host: skhokho.ai
Content-Type: application/json
Accept: */*
Content-Length: 493

{
  "name": "text",
  "description": "text",
  "asset_code": "text",
  "serial_number": "text",
  "asset_type": "ppe",
  "category": "text",
  "brand": "text",
  "model": "text",
  "purchase_price": "text",
  "useful_life_years": 1,
  "purchase_date": "2026-02-18",
  "warranty_expiry_date": "2026-02-18",
  "disposal_date": "2026-02-18",
  "status": "active",
  "condition": "excellent",
  "location": "text",
  "assigned_to_id": "text",
  "image": "binary",
  "receipt_document": "binary",
  "supplier_name": "text",
  "purchase_order_number": "text",
  "invoice_number": "text"
}

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

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "asset_code": "text",
  "serial_number": "text",
  "asset_type": "ppe",
  "category": "text",
  "brand": "text",
  "model": "text",
  "purchase_price": "text",
  "useful_life_years": 1,
  "purchase_date": "2026-02-18",
  "warranty_expiry_date": "2026-02-18",
  "disposal_date": "2026-02-18",
  "status": "active",
  "condition": "excellent",
  "location": "text",
  "assigned_to": {
    "unique_id": "text",
    "full_name": "text"
  },
  "image_url": "text",
  "receipt_document_url": "text",
  "supplier_name": "text",
  "purchase_order_number": "text",
  "invoice_number": "text",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "is_warranty_expired": true,
  "years_since_purchase": 1,
  "date_created": "2026-02-18T03:18:06.270Z",
  "last_updated": "2026-02-18T03:18:06.270Z"
}

Update asset

patch

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{org_uid}/assets/{unique_id}/update/

Update asset information (PUT for full update, PATCH for partial)

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

org_uidstringRequired

unique_idstringRequired

Body

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

Full serializer for Asset creation and updates. Handles translatable fields correctly.

namestring · min: 1 · max: 300Optional

descriptionstring · nullableOptional

asset_codestring · max: 100 · nullableOptional

serial_numberstring · max: 200 · nullableOptional

asset_typestring · enumOptional

Asset type is required.

• ppe - Property, Plant & Equipment
• equipment - Equipment
• furniture - Furniture & Fixtures
• vehicle - Vehicle
• computer - Computer & IT Equipment
• software - Software
• building - Building
• land - Land
• intangible - Intangible Asset
• other - Other

Possible values:

categorystring · max: 200 · nullableOptional

brandstring · max: 200 · nullableOptional

modelstring · max: 200 · nullableOptional

purchase_pricestring · decimalOptional

Purchase price is required and must be non-negative.

Pattern: ^-?\d{0,13}(?:\.\d{0,2})?$

useful_life_yearsinteger · min: 1 · max: 100Optional

Expected useful life in years

purchase_datestring · dateOptional

Purchase date is required.

warranty_expiry_datestring · date · nullableOptional

disposal_datestring · date · nullableOptional

statusstring · enumOptional

• active - Active
• inactive - Inactive
• disposed - Disposed
• sold - Sold
• damaged - Damaged
• under_repair - Under Repair
• stolen - Stolen

Possible values:

conditionstring · enumOptional

• excellent - Excellent
• good - Good
• fair - Fair
• poor - Poor
• damaged - Damaged

Possible values:

locationstring · max: 300 · nullableOptional

assigned_to_idstring · min: 1 · nullableWrite-onlyOptional

Unique ID of person to assign asset to

imagestring · binary · nullableOptional

Asset image for identification

receipt_documentstring · binary · nullableOptional

Upload receipt, invoice, or purchase document (PDF, DOC, DOCX, JPG, PNG)

supplier_namestring · max: 300 · nullableOptional

purchase_order_numberstring · max: 100 · nullableOptional

invoice_numberstring · max: 100 · nullableOptional

Responses

200Success

application/json

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

patch

/api/v1.0/organisation/{org_uid}/assets/{unique_id}/update/

HTTPcURLJavaScriptPython

PATCH /api/v1.0/organisation/{org_uid}/assets/{unique_id}/update/ HTTP/1.1
Host: skhokho.ai
Content-Type: application/json
Accept: */*
Content-Length: 493

{
  "name": "text",
  "description": "text",
  "asset_code": "text",
  "serial_number": "text",
  "asset_type": "ppe",
  "category": "text",
  "brand": "text",
  "model": "text",
  "purchase_price": "text",
  "useful_life_years": 1,
  "purchase_date": "2026-02-18",
  "warranty_expiry_date": "2026-02-18",
  "disposal_date": "2026-02-18",
  "status": "active",
  "condition": "excellent",
  "location": "text",
  "assigned_to_id": "text",
  "image": "binary",
  "receipt_document": "binary",
  "supplier_name": "text",
  "purchase_order_number": "text",
  "invoice_number": "text"
}

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

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "asset_code": "text",
  "serial_number": "text",
  "asset_type": "ppe",
  "category": "text",
  "brand": "text",
  "model": "text",
  "purchase_price": "text",
  "useful_life_years": 1,
  "purchase_date": "2026-02-18",
  "warranty_expiry_date": "2026-02-18",
  "disposal_date": "2026-02-18",
  "status": "active",
  "condition": "excellent",
  "location": "text",
  "assigned_to": {
    "unique_id": "text",
    "full_name": "text"
  },
  "image_url": "text",
  "receipt_document_url": "text",
  "supplier_name": "text",
  "purchase_order_number": "text",
  "invoice_number": "text",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "is_warranty_expired": true,
  "years_since_purchase": 1,
  "date_created": "2026-02-18T03:18:06.270Z",
  "last_updated": "2026-02-18T03:18:06.270Z"
}

Perform action on asset

get

https://skhokho.aihttp://102.209.118.152:8000/https://dev.skhokho.ai

/api/v1.0/organisation/{org_uid}/assets/{unique_id}/action/

Perform actions on an asset (deactivate, mark_disposed). Uses query parameters.

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

org_uidstringRequired

unique_idstringRequired

Query parameters

actionstring · enumRequired

Action to perform: deactivate or mark_disposed

Possible values:

Responses

200Success

application/json

400

Bad Request - Invalid action

401

Unauthorized

403

Forbidden

404

Not Found

get

/api/v1.0/organisation/{org_uid}/assets/{unique_id}/action/

HTTPcURLJavaScriptPython

GET /api/v1.0/organisation/{org_uid}/assets/{unique_id}/action/?action=deactivate HTTP/1.1
Host: skhokho.ai
Accept: */*

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "asset_code": "text",
  "serial_number": "text",
  "asset_type": "ppe",
  "category": "text",
  "brand": "text",
  "model": "text",
  "purchase_price": "text",
  "useful_life_years": 1,
  "purchase_date": "2026-02-18",
  "warranty_expiry_date": "2026-02-18",
  "disposal_date": "2026-02-18",
  "status": "active",
  "condition": "excellent",
  "location": "text",
  "assigned_to": {
    "unique_id": "text",
    "full_name": "text"
  },
  "image_url": "text",
  "receipt_document_url": "text",
  "supplier_name": "text",
  "purchase_order_number": "text",
  "invoice_number": "text",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "is_warranty_expired": true,
  "years_since_purchase": 1,
  "date_created": "2026-02-18T03:18:06.270Z",
  "last_updated": "2026-02-18T03:18:06.270Z"
}