> For the complete documentation index, see [llms.txt](https://docs.skhokho.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skhokho.ai/assets/liabilities.md).

# 📉 Liabilities

Liability and obligation tracking

## List liabilities

> Get a paginated list of liabilities with optional filters

```json
{"openapi":"3.0.3","info":{"title":"Skhokho API","version":"v1.0"},"tags":[{"name":"Liabilities","description":"Liability and obligation tracking"}],"servers":[{"url":"https://skhokho.ai","description":"Production"},{"url":"http://102.209.118.152:8000/","description":"Local"},{"url":"https://dev.skhokho.ai","description":"Development"}],"security":[{"cookieAuth":[]},{"basicAuth":[]}],"components":{"securitySchemes":{"cookieAuth":{"type":"apiKey","in":"cookie","name":"sessionid"},"basicAuth":{"type":"http","scheme":"basic"}},"schemas":{"LiabilityList":{"type":"object","description":"Lightweight serializer for liability lists.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"name":{"type":"string","readOnly":true},"liability_code":{"type":"string","nullable":true,"maxLength":100},"reference_number":{"type":"string","nullable":true,"maxLength":200},"liability_type":{"enum":["accounts_payable","notes_payable","loans_payable","mortgage_payable","bonds_payable","accrued_expenses","deferred_revenue","tax_payable","salary_payable","interest_payable","rent_payable","utilities_payable","lease_obligations","warranty_obligations","legal_obligations","other"],"type":"string","description":"* `accounts_payable` - Accounts Payable\n* `notes_payable` - Notes Payable\n* `loans_payable` - Loans Payable\n* `mortgage_payable` - Mortgage Payable\n* `bonds_payable` - Bonds Payable\n* `accrued_expenses` - Accrued Expenses\n* `deferred_revenue` - Deferred Revenue\n* `tax_payable` - Tax Payable\n* `salary_payable` - Salary/Wages Payable\n* `interest_payable` - Interest Payable\n* `rent_payable` - Rent Payable\n* `utilities_payable` - Utilities Payable\n* `lease_obligations` - Lease Obligations\n* `warranty_obligations` - Warranty Obligations\n* `legal_obligations` - Legal Obligations\n* `other` - Other"},"classification":{"enum":["current","non_current","contingent"],"type":"string","description":"* `current` - Current Liability\n* `non_current` - Non-Current Liability\n* `contingent` - Contingent Liability"},"original_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Original liability amount"},"current_balance":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Current outstanding balance"},"remaining_balance":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","readOnly":true},"paid_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Total amount paid so far"},"liability_date":{"type":"string","format":"date","description":"Date when liability was incurred"},"due_date":{"type":"string","format":"date","nullable":true},"status":{"enum":["pending","overdue","paid","partially_paid","disputed","cancelled","deferred"],"type":"string","description":"* `pending` - Pending\n* `overdue` - Overdue\n* `paid` - Paid\n* `partially_paid` - Partially Paid\n* `disputed` - Disputed\n* `cancelled` - Cancelled\n* `deferred` - Deferred"},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"creditor_name":{"type":"string","nullable":true,"title":"Creditor/Vendor Name","maxLength":300},"is_overdue":{"type":"boolean","readOnly":true},"date_created":{"type":"string","format":"date-time","nullable":true}},"required":["current_balance","is_overdue","liability_date","name","original_amount","remaining_balance"]}}},"paths":{"/api/v1.0/organisation/{org_uid}/liabilities/":{"get":{"operationId":"organisation_liabilities_list","description":"Get a paginated list of liabilities with optional filters","summary":"List liabilities","parameters":[{"in":"query","name":"classification","schema":{"type":"string"},"description":"Filter liabilities by classification"},{"in":"query","name":"creditor","schema":{"type":"string"},"description":"Filter liabilities by creditor name"},{"in":"query","name":"liability_type","schema":{"type":"string"},"description":"Filter liabilities by type"},{"in":"query","name":"name","schema":{"type":"string"},"description":"Filter liabilities by name/title (case-insensitive partial match)"},{"in":"path","name":"org_uid","schema":{"type":"string"},"required":true},{"in":"query","name":"overdue","schema":{"type":"boolean"},"description":"Filter only overdue liabilities (true/false)"},{"in":"query","name":"search","schema":{"type":"string"},"description":"Search liabilities by name, code, reference number, or creditor"},{"in":"query","name":"status","schema":{"type":"string"},"description":"Filter liabilities by status (pending, overdue, paid, etc.)"}],"tags":["Liabilities"],"responses":{"200":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/LiabilityList"}}}},"description":""},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}}}}}}
```

## Create liability

> Create a new liability

```json
{"openapi":"3.0.3","info":{"title":"Skhokho API","version":"v1.0"},"tags":[{"name":"Liabilities","description":"Liability and obligation tracking"}],"servers":[{"url":"https://skhokho.ai","description":"Production"},{"url":"http://102.209.118.152:8000/","description":"Local"},{"url":"https://dev.skhokho.ai","description":"Development"}],"security":[{"cookieAuth":[]},{"basicAuth":[]}],"components":{"securitySchemes":{"cookieAuth":{"type":"apiKey","in":"cookie","name":"sessionid"},"basicAuth":{"type":"http","scheme":"basic"}},"schemas":{"LiabilityRequest":{"type":"object","description":"Full serializer for Liability creation and updates.\nHandles translatable fields correctly.","properties":{"name":{"type":"string","minLength":1,"maxLength":300},"description":{"type":"string","nullable":true},"liability_code":{"type":"string","nullable":true,"maxLength":100},"reference_number":{"type":"string","nullable":true,"maxLength":200},"liability_type":{"enum":["accounts_payable","notes_payable","loans_payable","mortgage_payable","bonds_payable","accrued_expenses","deferred_revenue","tax_payable","salary_payable","interest_payable","rent_payable","utilities_payable","lease_obligations","warranty_obligations","legal_obligations","other"],"type":"string","description":"* `accounts_payable` - Accounts Payable\n* `notes_payable` - Notes Payable\n* `loans_payable` - Loans Payable\n* `mortgage_payable` - Mortgage Payable\n* `bonds_payable` - Bonds Payable\n* `accrued_expenses` - Accrued Expenses\n* `deferred_revenue` - Deferred Revenue\n* `tax_payable` - Tax Payable\n* `salary_payable` - Salary/Wages Payable\n* `interest_payable` - Interest Payable\n* `rent_payable` - Rent Payable\n* `utilities_payable` - Utilities Payable\n* `lease_obligations` - Lease Obligations\n* `warranty_obligations` - Warranty Obligations\n* `legal_obligations` - Legal Obligations\n* `other` - Other"},"classification":{"enum":["current","non_current","contingent"],"type":"string","description":"* `current` - Current Liability\n* `non_current` - Non-Current Liability\n* `contingent` - Contingent Liability"},"original_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Original amount is required and must be non-negative."},"current_balance":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Current outstanding balance"},"paid_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Total amount paid so far"},"interest_rate":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true,"title":"Interest Rate (%)","description":"Annual interest rate percentage"},"liability_date":{"type":"string","format":"date","description":"Liability date is required."},"due_date":{"type":"string","format":"date","nullable":true},"payment_date":{"type":"string","format":"date","nullable":true},"maturity_date":{"type":"string","format":"date","nullable":true},"status":{"enum":["pending","overdue","paid","partially_paid","disputed","cancelled","deferred"],"type":"string","description":"* `pending` - Pending\n* `overdue` - Overdue\n* `paid` - Paid\n* `partially_paid` - Partially Paid\n* `disputed` - Disputed\n* `cancelled` - Cancelled\n* `deferred` - Deferred"},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"creditor_name":{"type":"string","nullable":true,"title":"Creditor/Vendor Name","maxLength":300},"creditor_contact":{"type":"string","nullable":true,"maxLength":200},"creditor_email":{"type":"string","format":"email","nullable":true,"maxLength":254},"creditor_phone":{"type":"string","nullable":true,"maxLength":50},"payment_terms":{"type":"string","nullable":true,"maxLength":200},"late_fee_rate":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true,"title":"Late Fee Rate (%)","description":"Late payment fee percentage"},"category":{"type":"string","nullable":true,"maxLength":200},"department":{"type":"string","nullable":true,"maxLength":200},"project_reference":{"type":"string","nullable":true,"maxLength":200},"supporting_document":{"type":"string","format":"binary","nullable":true,"description":"Upload contract, invoice, or agreement document (PDF, DOC, DOCX, JPG, PNG)"}},"required":["current_balance","liability_date","name","original_amount"]},"LiabilityDetail":{"type":"object","description":"Detailed serializer for single liability retrieval.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"name":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"liability_code":{"type":"string","nullable":true,"maxLength":100},"reference_number":{"type":"string","nullable":true,"maxLength":200},"liability_type":{"enum":["accounts_payable","notes_payable","loans_payable","mortgage_payable","bonds_payable","accrued_expenses","deferred_revenue","tax_payable","salary_payable","interest_payable","rent_payable","utilities_payable","lease_obligations","warranty_obligations","legal_obligations","other"],"type":"string","description":"* `accounts_payable` - Accounts Payable\n* `notes_payable` - Notes Payable\n* `loans_payable` - Loans Payable\n* `mortgage_payable` - Mortgage Payable\n* `bonds_payable` - Bonds Payable\n* `accrued_expenses` - Accrued Expenses\n* `deferred_revenue` - Deferred Revenue\n* `tax_payable` - Tax Payable\n* `salary_payable` - Salary/Wages Payable\n* `interest_payable` - Interest Payable\n* `rent_payable` - Rent Payable\n* `utilities_payable` - Utilities Payable\n* `lease_obligations` - Lease Obligations\n* `warranty_obligations` - Warranty Obligations\n* `legal_obligations` - Legal Obligations\n* `other` - Other"},"classification":{"enum":["current","non_current","contingent"],"type":"string","description":"* `current` - Current Liability\n* `non_current` - Non-Current Liability\n* `contingent` - Contingent Liability"},"original_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Original liability amount"},"current_balance":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Current outstanding balance"},"remaining_balance":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","readOnly":true},"paid_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Total amount paid so far"},"interest_rate":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true,"title":"Interest Rate (%)","description":"Annual interest rate percentage"},"liability_date":{"type":"string","format":"date","description":"Date when liability was incurred"},"due_date":{"type":"string","format":"date","nullable":true},"payment_date":{"type":"string","format":"date","nullable":true},"maturity_date":{"type":"string","format":"date","nullable":true},"status":{"enum":["pending","overdue","paid","partially_paid","disputed","cancelled","deferred"],"type":"string","description":"* `pending` - Pending\n* `overdue` - Overdue\n* `paid` - Paid\n* `partially_paid` - Partially Paid\n* `disputed` - Disputed\n* `cancelled` - Cancelled\n* `deferred` - Deferred"},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"creditor_name":{"type":"string","nullable":true,"title":"Creditor/Vendor Name","maxLength":300},"creditor_contact":{"type":"string","nullable":true,"maxLength":200},"creditor_email":{"type":"string","format":"email","nullable":true,"maxLength":254},"creditor_phone":{"type":"string","nullable":true,"maxLength":50},"payment_terms":{"type":"string","nullable":true,"maxLength":200},"late_fee_rate":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true,"title":"Late Fee Rate (%)","description":"Late payment fee percentage"},"category":{"type":"string","nullable":true,"maxLength":200},"department":{"type":"string","nullable":true,"maxLength":200},"project_reference":{"type":"string","nullable":true,"maxLength":200},"supporting_document_url":{"type":"string","format":"uri","nullable":true,"readOnly":true},"created_by":{"allOf":[{"$ref":"#/components/schemas/LiabilityPersonMini"}],"readOnly":true},"is_overdue":{"type":"boolean","readOnly":true},"days_until_due":{"type":"integer","nullable":true,"readOnly":true},"date_created":{"type":"string","format":"date-time","nullable":true},"last_updated":{"type":"string","format":"date-time","nullable":true}},"required":["created_by","current_balance","days_until_due","description","is_overdue","liability_date","name","original_amount","remaining_balance","supporting_document_url"]},"LiabilityPersonMini":{"type":"object","description":"Lightweight serializer for Person references.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"full_name":{"type":"string","nullable":true,"readOnly":true}},"required":["full_name"]}}},"paths":{"/api/v1.0/organisation/{org_uid}/liabilities/create/":{"post":{"operationId":"organisation_liabilities_create_create","description":"Create a new liability","summary":"Create liability","parameters":[{"in":"path","name":"org_uid","schema":{"type":"string"},"required":true}],"tags":["Liabilities"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiabilityRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/LiabilityRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/LiabilityRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiabilityDetail"}}},"description":""},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}}}}}}
```

## Retrieve liability

> Get detailed information about a specific liability

```json
{"openapi":"3.0.3","info":{"title":"Skhokho API","version":"v1.0"},"tags":[{"name":"Liabilities","description":"Liability and obligation tracking"}],"servers":[{"url":"https://skhokho.ai","description":"Production"},{"url":"http://102.209.118.152:8000/","description":"Local"},{"url":"https://dev.skhokho.ai","description":"Development"}],"security":[{"cookieAuth":[]},{"basicAuth":[]}],"components":{"securitySchemes":{"cookieAuth":{"type":"apiKey","in":"cookie","name":"sessionid"},"basicAuth":{"type":"http","scheme":"basic"}},"schemas":{"LiabilityDetail":{"type":"object","description":"Detailed serializer for single liability retrieval.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"name":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"liability_code":{"type":"string","nullable":true,"maxLength":100},"reference_number":{"type":"string","nullable":true,"maxLength":200},"liability_type":{"enum":["accounts_payable","notes_payable","loans_payable","mortgage_payable","bonds_payable","accrued_expenses","deferred_revenue","tax_payable","salary_payable","interest_payable","rent_payable","utilities_payable","lease_obligations","warranty_obligations","legal_obligations","other"],"type":"string","description":"* `accounts_payable` - Accounts Payable\n* `notes_payable` - Notes Payable\n* `loans_payable` - Loans Payable\n* `mortgage_payable` - Mortgage Payable\n* `bonds_payable` - Bonds Payable\n* `accrued_expenses` - Accrued Expenses\n* `deferred_revenue` - Deferred Revenue\n* `tax_payable` - Tax Payable\n* `salary_payable` - Salary/Wages Payable\n* `interest_payable` - Interest Payable\n* `rent_payable` - Rent Payable\n* `utilities_payable` - Utilities Payable\n* `lease_obligations` - Lease Obligations\n* `warranty_obligations` - Warranty Obligations\n* `legal_obligations` - Legal Obligations\n* `other` - Other"},"classification":{"enum":["current","non_current","contingent"],"type":"string","description":"* `current` - Current Liability\n* `non_current` - Non-Current Liability\n* `contingent` - Contingent Liability"},"original_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Original liability amount"},"current_balance":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Current outstanding balance"},"remaining_balance":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","readOnly":true},"paid_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Total amount paid so far"},"interest_rate":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true,"title":"Interest Rate (%)","description":"Annual interest rate percentage"},"liability_date":{"type":"string","format":"date","description":"Date when liability was incurred"},"due_date":{"type":"string","format":"date","nullable":true},"payment_date":{"type":"string","format":"date","nullable":true},"maturity_date":{"type":"string","format":"date","nullable":true},"status":{"enum":["pending","overdue","paid","partially_paid","disputed","cancelled","deferred"],"type":"string","description":"* `pending` - Pending\n* `overdue` - Overdue\n* `paid` - Paid\n* `partially_paid` - Partially Paid\n* `disputed` - Disputed\n* `cancelled` - Cancelled\n* `deferred` - Deferred"},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"creditor_name":{"type":"string","nullable":true,"title":"Creditor/Vendor Name","maxLength":300},"creditor_contact":{"type":"string","nullable":true,"maxLength":200},"creditor_email":{"type":"string","format":"email","nullable":true,"maxLength":254},"creditor_phone":{"type":"string","nullable":true,"maxLength":50},"payment_terms":{"type":"string","nullable":true,"maxLength":200},"late_fee_rate":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true,"title":"Late Fee Rate (%)","description":"Late payment fee percentage"},"category":{"type":"string","nullable":true,"maxLength":200},"department":{"type":"string","nullable":true,"maxLength":200},"project_reference":{"type":"string","nullable":true,"maxLength":200},"supporting_document_url":{"type":"string","format":"uri","nullable":true,"readOnly":true},"created_by":{"allOf":[{"$ref":"#/components/schemas/LiabilityPersonMini"}],"readOnly":true},"is_overdue":{"type":"boolean","readOnly":true},"days_until_due":{"type":"integer","nullable":true,"readOnly":true},"date_created":{"type":"string","format":"date-time","nullable":true},"last_updated":{"type":"string","format":"date-time","nullable":true}},"required":["created_by","current_balance","days_until_due","description","is_overdue","liability_date","name","original_amount","remaining_balance","supporting_document_url"]},"LiabilityPersonMini":{"type":"object","description":"Lightweight serializer for Person references.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"full_name":{"type":"string","nullable":true,"readOnly":true}},"required":["full_name"]}}},"paths":{"/api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/":{"get":{"operationId":"organisation_liabilities_retrieve","description":"Get detailed information about a specific liability","summary":"Retrieve liability","parameters":[{"in":"path","name":"org_uid","schema":{"type":"string"},"required":true},{"in":"path","name":"unique_id","schema":{"type":"string"},"required":true}],"tags":["Liabilities"],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiabilityDetail"}}},"description":""},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}}}}}}
```

## Update liability

> Update liability information (PUT for full update, PATCH for partial)

```json
{"openapi":"3.0.3","info":{"title":"Skhokho API","version":"v1.0"},"tags":[{"name":"Liabilities","description":"Liability and obligation tracking"}],"servers":[{"url":"https://skhokho.ai","description":"Production"},{"url":"http://102.209.118.152:8000/","description":"Local"},{"url":"https://dev.skhokho.ai","description":"Development"}],"security":[{"cookieAuth":[]},{"basicAuth":[]}],"components":{"securitySchemes":{"cookieAuth":{"type":"apiKey","in":"cookie","name":"sessionid"},"basicAuth":{"type":"http","scheme":"basic"}},"schemas":{"LiabilityRequest":{"type":"object","description":"Full serializer for Liability creation and updates.\nHandles translatable fields correctly.","properties":{"name":{"type":"string","minLength":1,"maxLength":300},"description":{"type":"string","nullable":true},"liability_code":{"type":"string","nullable":true,"maxLength":100},"reference_number":{"type":"string","nullable":true,"maxLength":200},"liability_type":{"enum":["accounts_payable","notes_payable","loans_payable","mortgage_payable","bonds_payable","accrued_expenses","deferred_revenue","tax_payable","salary_payable","interest_payable","rent_payable","utilities_payable","lease_obligations","warranty_obligations","legal_obligations","other"],"type":"string","description":"* `accounts_payable` - Accounts Payable\n* `notes_payable` - Notes Payable\n* `loans_payable` - Loans Payable\n* `mortgage_payable` - Mortgage Payable\n* `bonds_payable` - Bonds Payable\n* `accrued_expenses` - Accrued Expenses\n* `deferred_revenue` - Deferred Revenue\n* `tax_payable` - Tax Payable\n* `salary_payable` - Salary/Wages Payable\n* `interest_payable` - Interest Payable\n* `rent_payable` - Rent Payable\n* `utilities_payable` - Utilities Payable\n* `lease_obligations` - Lease Obligations\n* `warranty_obligations` - Warranty Obligations\n* `legal_obligations` - Legal Obligations\n* `other` - Other"},"classification":{"enum":["current","non_current","contingent"],"type":"string","description":"* `current` - Current Liability\n* `non_current` - Non-Current Liability\n* `contingent` - Contingent Liability"},"original_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Original amount is required and must be non-negative."},"current_balance":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Current outstanding balance"},"paid_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Total amount paid so far"},"interest_rate":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true,"title":"Interest Rate (%)","description":"Annual interest rate percentage"},"liability_date":{"type":"string","format":"date","description":"Liability date is required."},"due_date":{"type":"string","format":"date","nullable":true},"payment_date":{"type":"string","format":"date","nullable":true},"maturity_date":{"type":"string","format":"date","nullable":true},"status":{"enum":["pending","overdue","paid","partially_paid","disputed","cancelled","deferred"],"type":"string","description":"* `pending` - Pending\n* `overdue` - Overdue\n* `paid` - Paid\n* `partially_paid` - Partially Paid\n* `disputed` - Disputed\n* `cancelled` - Cancelled\n* `deferred` - Deferred"},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"creditor_name":{"type":"string","nullable":true,"title":"Creditor/Vendor Name","maxLength":300},"creditor_contact":{"type":"string","nullable":true,"maxLength":200},"creditor_email":{"type":"string","format":"email","nullable":true,"maxLength":254},"creditor_phone":{"type":"string","nullable":true,"maxLength":50},"payment_terms":{"type":"string","nullable":true,"maxLength":200},"late_fee_rate":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true,"title":"Late Fee Rate (%)","description":"Late payment fee percentage"},"category":{"type":"string","nullable":true,"maxLength":200},"department":{"type":"string","nullable":true,"maxLength":200},"project_reference":{"type":"string","nullable":true,"maxLength":200},"supporting_document":{"type":"string","format":"binary","nullable":true,"description":"Upload contract, invoice, or agreement document (PDF, DOC, DOCX, JPG, PNG)"}},"required":["current_balance","liability_date","name","original_amount"]},"LiabilityDetail":{"type":"object","description":"Detailed serializer for single liability retrieval.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"name":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"liability_code":{"type":"string","nullable":true,"maxLength":100},"reference_number":{"type":"string","nullable":true,"maxLength":200},"liability_type":{"enum":["accounts_payable","notes_payable","loans_payable","mortgage_payable","bonds_payable","accrued_expenses","deferred_revenue","tax_payable","salary_payable","interest_payable","rent_payable","utilities_payable","lease_obligations","warranty_obligations","legal_obligations","other"],"type":"string","description":"* `accounts_payable` - Accounts Payable\n* `notes_payable` - Notes Payable\n* `loans_payable` - Loans Payable\n* `mortgage_payable` - Mortgage Payable\n* `bonds_payable` - Bonds Payable\n* `accrued_expenses` - Accrued Expenses\n* `deferred_revenue` - Deferred Revenue\n* `tax_payable` - Tax Payable\n* `salary_payable` - Salary/Wages Payable\n* `interest_payable` - Interest Payable\n* `rent_payable` - Rent Payable\n* `utilities_payable` - Utilities Payable\n* `lease_obligations` - Lease Obligations\n* `warranty_obligations` - Warranty Obligations\n* `legal_obligations` - Legal Obligations\n* `other` - Other"},"classification":{"enum":["current","non_current","contingent"],"type":"string","description":"* `current` - Current Liability\n* `non_current` - Non-Current Liability\n* `contingent` - Contingent Liability"},"original_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Original liability amount"},"current_balance":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Current outstanding balance"},"remaining_balance":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","readOnly":true},"paid_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Total amount paid so far"},"interest_rate":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true,"title":"Interest Rate (%)","description":"Annual interest rate percentage"},"liability_date":{"type":"string","format":"date","description":"Date when liability was incurred"},"due_date":{"type":"string","format":"date","nullable":true},"payment_date":{"type":"string","format":"date","nullable":true},"maturity_date":{"type":"string","format":"date","nullable":true},"status":{"enum":["pending","overdue","paid","partially_paid","disputed","cancelled","deferred"],"type":"string","description":"* `pending` - Pending\n* `overdue` - Overdue\n* `paid` - Paid\n* `partially_paid` - Partially Paid\n* `disputed` - Disputed\n* `cancelled` - Cancelled\n* `deferred` - Deferred"},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"creditor_name":{"type":"string","nullable":true,"title":"Creditor/Vendor Name","maxLength":300},"creditor_contact":{"type":"string","nullable":true,"maxLength":200},"creditor_email":{"type":"string","format":"email","nullable":true,"maxLength":254},"creditor_phone":{"type":"string","nullable":true,"maxLength":50},"payment_terms":{"type":"string","nullable":true,"maxLength":200},"late_fee_rate":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true,"title":"Late Fee Rate (%)","description":"Late payment fee percentage"},"category":{"type":"string","nullable":true,"maxLength":200},"department":{"type":"string","nullable":true,"maxLength":200},"project_reference":{"type":"string","nullable":true,"maxLength":200},"supporting_document_url":{"type":"string","format":"uri","nullable":true,"readOnly":true},"created_by":{"allOf":[{"$ref":"#/components/schemas/LiabilityPersonMini"}],"readOnly":true},"is_overdue":{"type":"boolean","readOnly":true},"days_until_due":{"type":"integer","nullable":true,"readOnly":true},"date_created":{"type":"string","format":"date-time","nullable":true},"last_updated":{"type":"string","format":"date-time","nullable":true}},"required":["created_by","current_balance","days_until_due","description","is_overdue","liability_date","name","original_amount","remaining_balance","supporting_document_url"]},"LiabilityPersonMini":{"type":"object","description":"Lightweight serializer for Person references.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"full_name":{"type":"string","nullable":true,"readOnly":true}},"required":["full_name"]}}},"paths":{"/api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/update/":{"put":{"operationId":"organisation_liabilities_update_update","description":"Update liability information (PUT for full update, PATCH for partial)","summary":"Update liability","parameters":[{"in":"path","name":"org_uid","schema":{"type":"string"},"required":true},{"in":"path","name":"unique_id","schema":{"type":"string"},"required":true}],"tags":["Liabilities"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiabilityRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/LiabilityRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/LiabilityRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiabilityDetail"}}},"description":""},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}}}}}}
```

## Update liability

> Update liability information (PUT for full update, PATCH for partial)

```json
{"openapi":"3.0.3","info":{"title":"Skhokho API","version":"v1.0"},"tags":[{"name":"Liabilities","description":"Liability and obligation tracking"}],"servers":[{"url":"https://skhokho.ai","description":"Production"},{"url":"http://102.209.118.152:8000/","description":"Local"},{"url":"https://dev.skhokho.ai","description":"Development"}],"security":[{"cookieAuth":[]},{"basicAuth":[]}],"components":{"securitySchemes":{"cookieAuth":{"type":"apiKey","in":"cookie","name":"sessionid"},"basicAuth":{"type":"http","scheme":"basic"}},"schemas":{"PatchedLiabilityRequest":{"type":"object","description":"Full serializer for Liability creation and updates.\nHandles translatable fields correctly.","properties":{"name":{"type":"string","minLength":1,"maxLength":300},"description":{"type":"string","nullable":true},"liability_code":{"type":"string","nullable":true,"maxLength":100},"reference_number":{"type":"string","nullable":true,"maxLength":200},"liability_type":{"enum":["accounts_payable","notes_payable","loans_payable","mortgage_payable","bonds_payable","accrued_expenses","deferred_revenue","tax_payable","salary_payable","interest_payable","rent_payable","utilities_payable","lease_obligations","warranty_obligations","legal_obligations","other"],"type":"string","description":"* `accounts_payable` - Accounts Payable\n* `notes_payable` - Notes Payable\n* `loans_payable` - Loans Payable\n* `mortgage_payable` - Mortgage Payable\n* `bonds_payable` - Bonds Payable\n* `accrued_expenses` - Accrued Expenses\n* `deferred_revenue` - Deferred Revenue\n* `tax_payable` - Tax Payable\n* `salary_payable` - Salary/Wages Payable\n* `interest_payable` - Interest Payable\n* `rent_payable` - Rent Payable\n* `utilities_payable` - Utilities Payable\n* `lease_obligations` - Lease Obligations\n* `warranty_obligations` - Warranty Obligations\n* `legal_obligations` - Legal Obligations\n* `other` - Other"},"classification":{"enum":["current","non_current","contingent"],"type":"string","description":"* `current` - Current Liability\n* `non_current` - Non-Current Liability\n* `contingent` - Contingent Liability"},"original_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Original amount is required and must be non-negative."},"current_balance":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Current outstanding balance"},"paid_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Total amount paid so far"},"interest_rate":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true,"title":"Interest Rate (%)","description":"Annual interest rate percentage"},"liability_date":{"type":"string","format":"date","description":"Liability date is required."},"due_date":{"type":"string","format":"date","nullable":true},"payment_date":{"type":"string","format":"date","nullable":true},"maturity_date":{"type":"string","format":"date","nullable":true},"status":{"enum":["pending","overdue","paid","partially_paid","disputed","cancelled","deferred"],"type":"string","description":"* `pending` - Pending\n* `overdue` - Overdue\n* `paid` - Paid\n* `partially_paid` - Partially Paid\n* `disputed` - Disputed\n* `cancelled` - Cancelled\n* `deferred` - Deferred"},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"creditor_name":{"type":"string","nullable":true,"title":"Creditor/Vendor Name","maxLength":300},"creditor_contact":{"type":"string","nullable":true,"maxLength":200},"creditor_email":{"type":"string","format":"email","nullable":true,"maxLength":254},"creditor_phone":{"type":"string","nullable":true,"maxLength":50},"payment_terms":{"type":"string","nullable":true,"maxLength":200},"late_fee_rate":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true,"title":"Late Fee Rate (%)","description":"Late payment fee percentage"},"category":{"type":"string","nullable":true,"maxLength":200},"department":{"type":"string","nullable":true,"maxLength":200},"project_reference":{"type":"string","nullable":true,"maxLength":200},"supporting_document":{"type":"string","format":"binary","nullable":true,"description":"Upload contract, invoice, or agreement document (PDF, DOC, DOCX, JPG, PNG)"}}},"LiabilityDetail":{"type":"object","description":"Detailed serializer for single liability retrieval.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"name":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"liability_code":{"type":"string","nullable":true,"maxLength":100},"reference_number":{"type":"string","nullable":true,"maxLength":200},"liability_type":{"enum":["accounts_payable","notes_payable","loans_payable","mortgage_payable","bonds_payable","accrued_expenses","deferred_revenue","tax_payable","salary_payable","interest_payable","rent_payable","utilities_payable","lease_obligations","warranty_obligations","legal_obligations","other"],"type":"string","description":"* `accounts_payable` - Accounts Payable\n* `notes_payable` - Notes Payable\n* `loans_payable` - Loans Payable\n* `mortgage_payable` - Mortgage Payable\n* `bonds_payable` - Bonds Payable\n* `accrued_expenses` - Accrued Expenses\n* `deferred_revenue` - Deferred Revenue\n* `tax_payable` - Tax Payable\n* `salary_payable` - Salary/Wages Payable\n* `interest_payable` - Interest Payable\n* `rent_payable` - Rent Payable\n* `utilities_payable` - Utilities Payable\n* `lease_obligations` - Lease Obligations\n* `warranty_obligations` - Warranty Obligations\n* `legal_obligations` - Legal Obligations\n* `other` - Other"},"classification":{"enum":["current","non_current","contingent"],"type":"string","description":"* `current` - Current Liability\n* `non_current` - Non-Current Liability\n* `contingent` - Contingent Liability"},"original_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Original liability amount"},"current_balance":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Current outstanding balance"},"remaining_balance":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","readOnly":true},"paid_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Total amount paid so far"},"interest_rate":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true,"title":"Interest Rate (%)","description":"Annual interest rate percentage"},"liability_date":{"type":"string","format":"date","description":"Date when liability was incurred"},"due_date":{"type":"string","format":"date","nullable":true},"payment_date":{"type":"string","format":"date","nullable":true},"maturity_date":{"type":"string","format":"date","nullable":true},"status":{"enum":["pending","overdue","paid","partially_paid","disputed","cancelled","deferred"],"type":"string","description":"* `pending` - Pending\n* `overdue` - Overdue\n* `paid` - Paid\n* `partially_paid` - Partially Paid\n* `disputed` - Disputed\n* `cancelled` - Cancelled\n* `deferred` - Deferred"},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"creditor_name":{"type":"string","nullable":true,"title":"Creditor/Vendor Name","maxLength":300},"creditor_contact":{"type":"string","nullable":true,"maxLength":200},"creditor_email":{"type":"string","format":"email","nullable":true,"maxLength":254},"creditor_phone":{"type":"string","nullable":true,"maxLength":50},"payment_terms":{"type":"string","nullable":true,"maxLength":200},"late_fee_rate":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true,"title":"Late Fee Rate (%)","description":"Late payment fee percentage"},"category":{"type":"string","nullable":true,"maxLength":200},"department":{"type":"string","nullable":true,"maxLength":200},"project_reference":{"type":"string","nullable":true,"maxLength":200},"supporting_document_url":{"type":"string","format":"uri","nullable":true,"readOnly":true},"created_by":{"allOf":[{"$ref":"#/components/schemas/LiabilityPersonMini"}],"readOnly":true},"is_overdue":{"type":"boolean","readOnly":true},"days_until_due":{"type":"integer","nullable":true,"readOnly":true},"date_created":{"type":"string","format":"date-time","nullable":true},"last_updated":{"type":"string","format":"date-time","nullable":true}},"required":["created_by","current_balance","days_until_due","description","is_overdue","liability_date","name","original_amount","remaining_balance","supporting_document_url"]},"LiabilityPersonMini":{"type":"object","description":"Lightweight serializer for Person references.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"full_name":{"type":"string","nullable":true,"readOnly":true}},"required":["full_name"]}}},"paths":{"/api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/update/":{"patch":{"operationId":"organisation_liabilities_update_partial_update","description":"Update liability information (PUT for full update, PATCH for partial)","summary":"Update liability","parameters":[{"in":"path","name":"org_uid","schema":{"type":"string"},"required":true},{"in":"path","name":"unique_id","schema":{"type":"string"},"required":true}],"tags":["Liabilities"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedLiabilityRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedLiabilityRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedLiabilityRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiabilityDetail"}}},"description":""},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}}}}}}
```

## Perform action on liability

> Perform actions on a liability (mark\_paid, mark\_overdue). Uses query parameters.

```json
{"openapi":"3.0.3","info":{"title":"Skhokho API","version":"v1.0"},"tags":[{"name":"Liabilities","description":"Liability and obligation tracking"}],"servers":[{"url":"https://skhokho.ai","description":"Production"},{"url":"http://102.209.118.152:8000/","description":"Local"},{"url":"https://dev.skhokho.ai","description":"Development"}],"security":[{"cookieAuth":[]},{"basicAuth":[]}],"components":{"securitySchemes":{"cookieAuth":{"type":"apiKey","in":"cookie","name":"sessionid"},"basicAuth":{"type":"http","scheme":"basic"}},"schemas":{"LiabilityDetail":{"type":"object","description":"Detailed serializer for single liability retrieval.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"name":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"liability_code":{"type":"string","nullable":true,"maxLength":100},"reference_number":{"type":"string","nullable":true,"maxLength":200},"liability_type":{"enum":["accounts_payable","notes_payable","loans_payable","mortgage_payable","bonds_payable","accrued_expenses","deferred_revenue","tax_payable","salary_payable","interest_payable","rent_payable","utilities_payable","lease_obligations","warranty_obligations","legal_obligations","other"],"type":"string","description":"* `accounts_payable` - Accounts Payable\n* `notes_payable` - Notes Payable\n* `loans_payable` - Loans Payable\n* `mortgage_payable` - Mortgage Payable\n* `bonds_payable` - Bonds Payable\n* `accrued_expenses` - Accrued Expenses\n* `deferred_revenue` - Deferred Revenue\n* `tax_payable` - Tax Payable\n* `salary_payable` - Salary/Wages Payable\n* `interest_payable` - Interest Payable\n* `rent_payable` - Rent Payable\n* `utilities_payable` - Utilities Payable\n* `lease_obligations` - Lease Obligations\n* `warranty_obligations` - Warranty Obligations\n* `legal_obligations` - Legal Obligations\n* `other` - Other"},"classification":{"enum":["current","non_current","contingent"],"type":"string","description":"* `current` - Current Liability\n* `non_current` - Non-Current Liability\n* `contingent` - Contingent Liability"},"original_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Original liability amount"},"current_balance":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Current outstanding balance"},"remaining_balance":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","readOnly":true},"paid_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,13}(?:\\.\\d{0,2})?$","description":"Total amount paid so far"},"interest_rate":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true,"title":"Interest Rate (%)","description":"Annual interest rate percentage"},"liability_date":{"type":"string","format":"date","description":"Date when liability was incurred"},"due_date":{"type":"string","format":"date","nullable":true},"payment_date":{"type":"string","format":"date","nullable":true},"maturity_date":{"type":"string","format":"date","nullable":true},"status":{"enum":["pending","overdue","paid","partially_paid","disputed","cancelled","deferred"],"type":"string","description":"* `pending` - Pending\n* `overdue` - Overdue\n* `paid` - Paid\n* `partially_paid` - Partially Paid\n* `disputed` - Disputed\n* `cancelled` - Cancelled\n* `deferred` - Deferred"},"priority":{"enum":["low","medium","high","critical"],"type":"string","description":"* `low` - Low\n* `medium` - Medium\n* `high` - High\n* `critical` - Critical"},"creditor_name":{"type":"string","nullable":true,"title":"Creditor/Vendor Name","maxLength":300},"creditor_contact":{"type":"string","nullable":true,"maxLength":200},"creditor_email":{"type":"string","format":"email","nullable":true,"maxLength":254},"creditor_phone":{"type":"string","nullable":true,"maxLength":50},"payment_terms":{"type":"string","nullable":true,"maxLength":200},"late_fee_rate":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,2})?$","nullable":true,"title":"Late Fee Rate (%)","description":"Late payment fee percentage"},"category":{"type":"string","nullable":true,"maxLength":200},"department":{"type":"string","nullable":true,"maxLength":200},"project_reference":{"type":"string","nullable":true,"maxLength":200},"supporting_document_url":{"type":"string","format":"uri","nullable":true,"readOnly":true},"created_by":{"allOf":[{"$ref":"#/components/schemas/LiabilityPersonMini"}],"readOnly":true},"is_overdue":{"type":"boolean","readOnly":true},"days_until_due":{"type":"integer","nullable":true,"readOnly":true},"date_created":{"type":"string","format":"date-time","nullable":true},"last_updated":{"type":"string","format":"date-time","nullable":true}},"required":["created_by","current_balance","days_until_due","description","is_overdue","liability_date","name","original_amount","remaining_balance","supporting_document_url"]},"LiabilityPersonMini":{"type":"object","description":"Lightweight serializer for Person references.","properties":{"unique_id":{"type":"string","nullable":true,"maxLength":100},"full_name":{"type":"string","nullable":true,"readOnly":true}},"required":["full_name"]}}},"paths":{"/api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/action/":{"get":{"operationId":"organisation_liabilities_action_retrieve","description":"Perform actions on a liability (mark_paid, mark_overdue). Uses query parameters.","summary":"Perform action on liability","parameters":[{"in":"query","name":"action","schema":{"type":"string","enum":["mark_overdue","mark_paid"]},"description":"Action to perform: mark_paid or mark_overdue","required":true},{"in":"path","name":"org_uid","schema":{"type":"string"},"required":true},{"in":"path","name":"unique_id","schema":{"type":"string"},"required":true}],"tags":["Liabilities"],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiabilityDetail"}}},"description":""},"400":{"description":"Bad Request - Invalid action"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}}}}}}
```