{"info":{"_postman_id":"15cdd4d1-e66e-4336-ad44-6d3c800119c4","name":"KMK REST API","description":"<html><head></head><body><h2 id=\"kmk-rest-api\">KMK REST API</h2>\n<p>This collection covers the <strong>Admin Access Control</strong> endpoints for the KMK360 LMS Admin platform (<code>lms-admin.demo.kmk360.com</code>). It provides full CRUD operations for managing the core access control entities used to govern user permissions within the system.</p>\n<h3 id=\"whats-covered\">What's covered</h3>\n<ul>\n<li><strong>Admin Users</strong> — Create, retrieve, update, delete, and restore administrator accounts.</li>\n<li><strong>Roles</strong> — Define and manage roles that can be assigned to users.</li>\n<li><strong>Permissions</strong> — Create, retrieve, update, and delete individual permission records.</li>\n<li><strong>Role Permissions</strong> — Assign or remove permissions from specific roles.</li>\n<li><strong>Role Users</strong> — Assign or remove users from specific roles.</li>\n</ul>\n<h3 id=\"structure\">Structure</h3>\n<p>Requests are organized into two <code>admin: access</code> folder groups, each containing sub-folders for <code>admin_users</code>, <code>roles</code>, <code>permissions</code>, <code>role_permissions</code>, and <code>role_users</code>. All endpoints follow a consistent REST pattern using <code>PUT</code> (create), <code>POST</code> (read/query), <code>PATCH</code> (update), and <code>DELETE</code> (remove).</p>\n<h3 id=\"base-url\">Base URL</h3>\n<p><code>https://lms-admin.demo.kmk360.com/api/access</code></p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"34768012","collectionId":"15cdd4d1-e66e-4336-ad44-6d3c800119c4","publishedId":"2sBXwmRtB6","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-05-27T23:56:56.000Z"},"item":[{"name":"admin: access","item":[{"name":"admin_users","item":[{"name":"Get All Admin User","id":"4120a60b-c7c3-4e06-bc86-1194c8f40082","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"request\": \"get-admin-users\",\n    \"filters\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/admin_users","urlObject":{"protocol":"https","path":["api","access","admin_users"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"4120a60b-c7c3-4e06-bc86-1194c8f40082"},{"name":"Create Admin User","id":"10ed6f6e-081a-4d6d-8681-c35963fa8593","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"first_name\": \"Test\",\n    \"last_name\": \"User\",\n    \"email_address\": \"engineering+testuser@kmkoptometry.com\",\n    \"password\": \"Rawr@123\",\n    \"confirm_password\": \"Rawr@123\",\n    \"admin_roles\": [\n        5\n    ],\n    \"booking_url\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/admin_users","urlObject":{"protocol":"https","path":["api","access","admin_users"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"10ed6f6e-081a-4d6d-8681-c35963fa8593"},{"name":"Update Admin User","id":"1a7c8944-786e-4f45-80be-0e8ba55cfc77","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"administrator_id\": 30775,\n    \"first_name\": \"Test2\",\n    \"last_name\": \"User\",\n    \"email_address\": \"engineering+testuser@kmkoptometry.com\",\n    \"admin_roles\": [\n        5,\n        43\n    ],\n    \"booking_url\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/admin_users","urlObject":{"protocol":"https","path":["api","access","admin_users"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"1a7c8944-786e-4f45-80be-0e8ba55cfc77"},{"name":"Delete Admin User","id":"68707eb6-e05f-4bbe-a6d8-84170b1557b6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"permission_id\": 30775\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/admin_users","urlObject":{"protocol":"https","path":["api","access","admin_users"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"68707eb6-e05f-4bbe-a6d8-84170b1557b6"},{"name":"Restore Admin User","id":"6f85dc83-e655-4999-866e-700f9a7e8584","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"request\": \"restore-admin-user\",\n\t\"administrator_id\": 30775\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/admin_users","urlObject":{"protocol":"https","path":["api","access","admin_users"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"6f85dc83-e655-4999-866e-700f9a7e8584"}],"id":"84c4716f-fc21-43ee-9fdd-ef263326e44a","_postman_id":"84c4716f-fc21-43ee-9fdd-ef263326e44a","description":""},{"name":"permissions","item":[{"name":"Get Permissions","id":"ee26b8a2-1020-4043-89b6-f14d8edbf077","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"request\": \"get_permissions\",\n    \"filters\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/permissions","urlObject":{"protocol":"https","path":["api","access","permissions"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"ee26b8a2-1020-4043-89b6-f14d8edbf077"},{"name":"Create Permissions","id":"09220f1e-a272-4d11-ba23-137b4123eef4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"permission_name\": \"base-textbooks2-index\",\n    \"permission_module\": \"base\",\n    \"module_controller\": \"textbooks2\",\n    \"controller_method\": \"view\",\n    \"method_name\": \"index\"\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/permissions","urlObject":{"protocol":"https","path":["api","access","permissions"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"09220f1e-a272-4d11-ba23-137b4123eef4"},{"name":"Update Permissions","id":"7eb70611-2504-4e8a-b1da-03cb4eae638a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"permission_id\": 752,\n    \"permission_name\": \"base-textbooks2-index\",\n    \"permission_module\": \"base\",\n    \"module_controller\": \"textbooks2\",\n    \"controller_method\": \"view\",\n    \"method_name\": \"index\"\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/permissions","urlObject":{"protocol":"https","path":["api","access","permissions"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"7eb70611-2504-4e8a-b1da-03cb4eae638a"},{"name":"Delete Permissions","id":"fc8bc266-2b23-4eed-a83c-9e05a2208dc5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"permission_id\": 752\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/permissions","urlObject":{"protocol":"https","path":["api","access","permissions"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"fc8bc266-2b23-4eed-a83c-9e05a2208dc5"}],"id":"7f9a2df1-70a2-467e-bc15-792744df62ce","_postman_id":"7f9a2df1-70a2-467e-bc15-792744df62ce","description":""},{"name":"roles","item":[{"name":"Get Roles","id":"bb260f28-4186-484b-b7e1-f0fb1ecfbee2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"filters\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/roles","urlObject":{"protocol":"https","path":["api","access","roles"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"bb260f28-4186-484b-b7e1-f0fb1ecfbee2"},{"name":"Create Roles","id":"244d1d01-0177-4717-871e-cbf8a29ac5c4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"role_name\":\"Test User Role\",\n    \"role_description\":\"Test User Role descript goes here\",\n    \"role_key\":\"test_user_role\"\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/roles","urlObject":{"protocol":"https","path":["api","access","roles"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"244d1d01-0177-4717-871e-cbf8a29ac5c4"},{"name":"Update Roles","id":"ba556957-03ce-4dde-8856-620792e115da","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"role_id\": 44,\n    \"role_name\":\"Test User Role\",\n    \"role_description\":\"Test User Role descript goes here\",\n    \"role_key\":\"test_user_role\"\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/roles","urlObject":{"protocol":"https","path":["api","access","roles"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"ba556957-03ce-4dde-8856-620792e115da"},{"name":"Delete Roles","id":"3914b8fa-fa29-4c43-b106-cb4f56b45aee","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"role_id\": 44\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/roles","urlObject":{"protocol":"https","path":["api","access","roles"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"3914b8fa-fa29-4c43-b106-cb4f56b45aee"}],"id":"e24db15b-3326-46af-987b-d100c8106a95","_postman_id":"e24db15b-3326-46af-987b-d100c8106a95","description":""},{"name":"role_permissions","item":[{"name":"Get Role Permissions","id":"1d544e55-f0db-495c-8425-50a63ab9ce52","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"filters\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/role_permissions","urlObject":{"protocol":"https","path":["api","access","role_permissions"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"1d544e55-f0db-495c-8425-50a63ab9ce52"},{"name":"Create Role Permissions","id":"fb9970ec-0a8a-4891-94d2-8abdcc807d5b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"role_id\": 45,\n    \"permission_id\": [\n        30,\n        31,\n        32\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/role_permissions","urlObject":{"protocol":"https","path":["api","access","role_permissions"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"fb9970ec-0a8a-4891-94d2-8abdcc807d5b"},{"name":"Delete Role Permissions","id":"83ec28a3-fa78-47f5-b434-0b84f926b92c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"id\": [\n        5129,\n        5130,\n        5131\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/role_permissions","urlObject":{"protocol":"https","path":["api","access","role_permissions"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"83ec28a3-fa78-47f5-b434-0b84f926b92c"}],"id":"ad350678-112b-40be-a393-79c9a66015a2","_postman_id":"ad350678-112b-40be-a393-79c9a66015a2","description":""},{"name":"role_users","item":[{"name":"Get Role Users","id":"c56eea45-92ce-43f8-abdf-0aadb340b4eb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"request\": \"users-no-role\",\n    \"role_id\": 45,\n    \"with\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/role_users","urlObject":{"protocol":"https","path":["api","access","role_users"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"c56eea45-92ce-43f8-abdf-0aadb340b4eb"},{"name":"Create Role Users","id":"21169dd1-a6ed-4b8d-8cb8-a6cff7f25679","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"role_id\": 45,\n    \"users\": [\n        5213\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/role_users","urlObject":{"protocol":"https","path":["api","access","role_users"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"21169dd1-a6ed-4b8d-8cb8-a6cff7f25679"},{"name":"Delete Role Users","id":"f3595765-32c0-4b94-92d8-f9df55ce857d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Auth-Key"},{"key":"value","value":"{{vault:auth-key-value}}"}]},"isInherited":false},"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n    \"api_access_secret\" : \"82f4941a97b20902679c09efb26480da\",\n    \"role_id\": 45,\n    \"id\": [\n        5213\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://lms-admin.demo.kmk360.com/api/access/role_users","urlObject":{"protocol":"https","path":["api","access","role_users"],"host":["lms-admin","demo","kmk360","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"f3595765-32c0-4b94-92d8-f9df55ce857d"}],"id":"54671d94-a214-4d3a-bb85-a045eb3d2549","_postman_id":"54671d94-a214-4d3a-bb85-a045eb3d2549","description":""}],"id":"082375ff-fdbd-40bd-9233-0b0955337d0b","description":"<h2 id=\"admin-access\">admin: access</h2>\n<p>This folder groups all endpoints related to the <strong>Access Control</strong> module of the KMK360 LMS Admin platform (<code>lms-admin.demo.kmk360.com</code>). It covers the full lifecycle management of users, roles, and permissions within the system.</p>\n<h3 id=\"sub-folders\">Sub-folders</h3>\n<ul>\n<li><strong>admin_users</strong> — Create, retrieve, update, delete, and restore administrator accounts.</li>\n<li><strong>roles</strong> — Define and manage roles that can be assigned to users.</li>\n<li><strong>permissions</strong> — Create, retrieve, update, and delete individual permission records.</li>\n<li><strong>role_permissions</strong> — Assign or remove permissions from specific roles.</li>\n<li><strong>role_users</strong> — Assign or remove users from specific roles.</li>\n</ul>\n<h3 id=\"endpoint-pattern\">Endpoint pattern</h3>\n<p>All requests follow a consistent REST convention:</p>\n<ul>\n<li><code>PUT</code> — Create a new record</li>\n<li><code>POST</code> — Read / query records</li>\n<li><code>PATCH</code> — Update an existing record</li>\n<li><code>DELETE</code> — Remove a record</li>\n</ul>\n","_postman_id":"082375ff-fdbd-40bd-9233-0b0955337d0b"}]}