{"openapi":"3.1.0","info":{"title":"Rolodex API","version":"0.1.0","description":"LDAP Sync Cache read API."},"components":{"schemas":{},"parameters":{}},"paths":{"/api/ldap-sync-cache/user/{username}":{"get":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"username","in":"path"}],"responses":{"200":{"description":"User information.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"mode":{"type":"integer"},"isPublic":{"type":"boolean"},"sAMAccountName":{"type":"string","nullable":true},"dssUsername":{"type":"string","nullable":true},"distinguishedName":{"type":"string","nullable":true},"employeeNumber":{"type":"string","nullable":true},"objectGUID":{"type":"string","nullable":true},"yellowpagesServiceId":{"type":"string","nullable":true},"displayName":{"type":"string","nullable":true},"givenName":{"type":"string","nullable":true},"sn":{"type":"string","nullable":true},"mail":{"type":"string","nullable":true},"workEmail":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"manager":{"type":"string","nullable":true},"managersEmail":{"type":"string","nullable":true},"managersName":{"type":"string","nullable":true},"managerIndividualContributor":{"type":"string","nullable":true},"isServiceAccount":{"type":"boolean","nullable":true},"serviceAccountEnvironment":{"type":"string","nullable":true},"usedExternally":{"type":"string","nullable":true},"employeeID":{"type":"string","nullable":true},"employeeType":{"type":"string","nullable":true},"workerType":{"type":"string","nullable":true},"workerStatus":{"type":"string","nullable":true},"workerJobLevel":{"type":"string","nullable":true},"businessCategory":{"type":"string","nullable":true},"costCenterUniqueId":{"type":"string","nullable":true},"anniversary":{"type":"string","nullable":true},"birthDate":{"type":"string","nullable":true},"whenCreated":{"type":"string","nullable":true},"telephoneNumber":{"type":"string","nullable":true},"physicalDeliveryOfficeName":{"type":"string","nullable":true},"seatingIDDisplayName":{"type":"string","nullable":true},"homeDirectory":{"type":"string","nullable":true},"loginShell":{"type":"string","nullable":true},"uidNumber":{"type":"string","nullable":true},"gidNumber":{"type":"string","nullable":true},"sshPublicKey":{"type":"string","nullable":true},"automationNote":{"type":"string","nullable":true},"importedFrom":{"type":"string","nullable":true},"memberOf":{"type":"array","items":{"type":"object","properties":{"group_name":{"type":"string"}},"required":["group_name"]}}},"required":["id","mode","isPublic","sAMAccountName","dssUsername","distinguishedName","employeeNumber","objectGUID","yellowpagesServiceId","displayName","givenName","sn","mail","workEmail","title","description","manager","managersEmail","managersName","managerIndividualContributor","isServiceAccount","serviceAccountEnvironment","usedExternally","employeeID","employeeType","workerType","workerStatus","workerJobLevel","businessCategory","costCenterUniqueId","anniversary","birthDate","whenCreated","telephoneNumber","physicalDeliveryOfficeName","seatingIDDisplayName","homeDirectory","loginShell","uidNumber","gidNumber","sshPublicKey","automationNote","importedFrom","memberOf"]}}}},"404":{"description":"User does not exist."}}}},"/api/ldap-sync-cache/user-by-dss-username/{dss_username}":{"get":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"dss_username","in":"path"}],"responses":{"200":{"description":"User information.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"mode":{"type":"integer"},"isPublic":{"type":"boolean"},"sAMAccountName":{"type":"string","nullable":true},"dssUsername":{"type":"string","nullable":true},"distinguishedName":{"type":"string","nullable":true},"employeeNumber":{"type":"string","nullable":true},"objectGUID":{"type":"string","nullable":true},"yellowpagesServiceId":{"type":"string","nullable":true},"displayName":{"type":"string","nullable":true},"givenName":{"type":"string","nullable":true},"sn":{"type":"string","nullable":true},"mail":{"type":"string","nullable":true},"workEmail":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"manager":{"type":"string","nullable":true},"managersEmail":{"type":"string","nullable":true},"managersName":{"type":"string","nullable":true},"managerIndividualContributor":{"type":"string","nullable":true},"isServiceAccount":{"type":"boolean","nullable":true},"serviceAccountEnvironment":{"type":"string","nullable":true},"usedExternally":{"type":"string","nullable":true},"employeeID":{"type":"string","nullable":true},"employeeType":{"type":"string","nullable":true},"workerType":{"type":"string","nullable":true},"workerStatus":{"type":"string","nullable":true},"workerJobLevel":{"type":"string","nullable":true},"businessCategory":{"type":"string","nullable":true},"costCenterUniqueId":{"type":"string","nullable":true},"anniversary":{"type":"string","nullable":true},"birthDate":{"type":"string","nullable":true},"whenCreated":{"type":"string","nullable":true},"telephoneNumber":{"type":"string","nullable":true},"physicalDeliveryOfficeName":{"type":"string","nullable":true},"seatingIDDisplayName":{"type":"string","nullable":true},"homeDirectory":{"type":"string","nullable":true},"loginShell":{"type":"string","nullable":true},"uidNumber":{"type":"string","nullable":true},"gidNumber":{"type":"string","nullable":true},"sshPublicKey":{"type":"string","nullable":true},"automationNote":{"type":"string","nullable":true},"importedFrom":{"type":"string","nullable":true},"memberOf":{"type":"array","items":{"type":"object","properties":{"group_name":{"type":"string"}},"required":["group_name"]}}},"required":["id","mode","isPublic","sAMAccountName","dssUsername","distinguishedName","employeeNumber","objectGUID","yellowpagesServiceId","displayName","givenName","sn","mail","workEmail","title","description","manager","managersEmail","managersName","managerIndividualContributor","isServiceAccount","serviceAccountEnvironment","usedExternally","employeeID","employeeType","workerType","workerStatus","workerJobLevel","businessCategory","costCenterUniqueId","anniversary","birthDate","whenCreated","telephoneNumber","physicalDeliveryOfficeName","seatingIDDisplayName","homeDirectory","loginShell","uidNumber","gidNumber","sshPublicKey","automationNote","importedFrom","memberOf"]}}}},"404":{"description":"User does not exist."}}}},"/api/ldap-sync-cache/user-by-distinguishedname/{distinguishedname}":{"get":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"distinguishedname","in":"path"}],"responses":{"200":{"description":"User information.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"mode":{"type":"integer"},"isPublic":{"type":"boolean"},"sAMAccountName":{"type":"string","nullable":true},"dssUsername":{"type":"string","nullable":true},"distinguishedName":{"type":"string","nullable":true},"employeeNumber":{"type":"string","nullable":true},"objectGUID":{"type":"string","nullable":true},"yellowpagesServiceId":{"type":"string","nullable":true},"displayName":{"type":"string","nullable":true},"givenName":{"type":"string","nullable":true},"sn":{"type":"string","nullable":true},"mail":{"type":"string","nullable":true},"workEmail":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"manager":{"type":"string","nullable":true},"managersEmail":{"type":"string","nullable":true},"managersName":{"type":"string","nullable":true},"managerIndividualContributor":{"type":"string","nullable":true},"isServiceAccount":{"type":"boolean","nullable":true},"serviceAccountEnvironment":{"type":"string","nullable":true},"usedExternally":{"type":"string","nullable":true},"employeeID":{"type":"string","nullable":true},"employeeType":{"type":"string","nullable":true},"workerType":{"type":"string","nullable":true},"workerStatus":{"type":"string","nullable":true},"workerJobLevel":{"type":"string","nullable":true},"businessCategory":{"type":"string","nullable":true},"costCenterUniqueId":{"type":"string","nullable":true},"anniversary":{"type":"string","nullable":true},"birthDate":{"type":"string","nullable":true},"whenCreated":{"type":"string","nullable":true},"telephoneNumber":{"type":"string","nullable":true},"physicalDeliveryOfficeName":{"type":"string","nullable":true},"seatingIDDisplayName":{"type":"string","nullable":true},"homeDirectory":{"type":"string","nullable":true},"loginShell":{"type":"string","nullable":true},"uidNumber":{"type":"string","nullable":true},"gidNumber":{"type":"string","nullable":true},"sshPublicKey":{"type":"string","nullable":true},"automationNote":{"type":"string","nullable":true},"importedFrom":{"type":"string","nullable":true},"memberOf":{"type":"array","items":{"type":"object","properties":{"group_name":{"type":"string"}},"required":["group_name"]}}},"required":["id","mode","isPublic","sAMAccountName","dssUsername","distinguishedName","employeeNumber","objectGUID","yellowpagesServiceId","displayName","givenName","sn","mail","workEmail","title","description","manager","managersEmail","managersName","managerIndividualContributor","isServiceAccount","serviceAccountEnvironment","usedExternally","employeeID","employeeType","workerType","workerStatus","workerJobLevel","businessCategory","costCenterUniqueId","anniversary","birthDate","whenCreated","telephoneNumber","physicalDeliveryOfficeName","seatingIDDisplayName","homeDirectory","loginShell","uidNumber","gidNumber","sshPublicKey","automationNote","importedFrom","memberOf"]}}}},"404":{"description":"User does not exist."}}}},"/api/ldap-sync-cache/user-by-employee-number/{employeeNumber}":{"get":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"employeeNumber","in":"path"}],"responses":{"200":{"description":"User information.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"mode":{"type":"integer"},"isPublic":{"type":"boolean"},"sAMAccountName":{"type":"string","nullable":true},"dssUsername":{"type":"string","nullable":true},"distinguishedName":{"type":"string","nullable":true},"employeeNumber":{"type":"string","nullable":true},"objectGUID":{"type":"string","nullable":true},"yellowpagesServiceId":{"type":"string","nullable":true},"displayName":{"type":"string","nullable":true},"givenName":{"type":"string","nullable":true},"sn":{"type":"string","nullable":true},"mail":{"type":"string","nullable":true},"workEmail":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"manager":{"type":"string","nullable":true},"managersEmail":{"type":"string","nullable":true},"managersName":{"type":"string","nullable":true},"managerIndividualContributor":{"type":"string","nullable":true},"isServiceAccount":{"type":"boolean","nullable":true},"serviceAccountEnvironment":{"type":"string","nullable":true},"usedExternally":{"type":"string","nullable":true},"employeeID":{"type":"string","nullable":true},"employeeType":{"type":"string","nullable":true},"workerType":{"type":"string","nullable":true},"workerStatus":{"type":"string","nullable":true},"workerJobLevel":{"type":"string","nullable":true},"businessCategory":{"type":"string","nullable":true},"costCenterUniqueId":{"type":"string","nullable":true},"anniversary":{"type":"string","nullable":true},"birthDate":{"type":"string","nullable":true},"whenCreated":{"type":"string","nullable":true},"telephoneNumber":{"type":"string","nullable":true},"physicalDeliveryOfficeName":{"type":"string","nullable":true},"seatingIDDisplayName":{"type":"string","nullable":true},"homeDirectory":{"type":"string","nullable":true},"loginShell":{"type":"string","nullable":true},"uidNumber":{"type":"string","nullable":true},"gidNumber":{"type":"string","nullable":true},"sshPublicKey":{"type":"string","nullable":true},"automationNote":{"type":"string","nullable":true},"importedFrom":{"type":"string","nullable":true},"memberOf":{"type":"array","items":{"type":"object","properties":{"group_name":{"type":"string"}},"required":["group_name"]}}},"required":["id","mode","isPublic","sAMAccountName","dssUsername","distinguishedName","employeeNumber","objectGUID","yellowpagesServiceId","displayName","givenName","sn","mail","workEmail","title","description","manager","managersEmail","managersName","managerIndividualContributor","isServiceAccount","serviceAccountEnvironment","usedExternally","employeeID","employeeType","workerType","workerStatus","workerJobLevel","businessCategory","costCenterUniqueId","anniversary","birthDate","whenCreated","telephoneNumber","physicalDeliveryOfficeName","seatingIDDisplayName","homeDirectory","loginShell","uidNumber","gidNumber","sshPublicKey","automationNote","importedFrom","memberOf"]}}}},"404":{"description":"User does not exist."}}}},"/api/ldap-sync-cache/user-by-objectguid/{objectGUID}":{"get":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"objectGUID","in":"path"}],"responses":{"200":{"description":"User information.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"mode":{"type":"integer"},"isPublic":{"type":"boolean"},"sAMAccountName":{"type":"string","nullable":true},"dssUsername":{"type":"string","nullable":true},"distinguishedName":{"type":"string","nullable":true},"employeeNumber":{"type":"string","nullable":true},"objectGUID":{"type":"string","nullable":true},"yellowpagesServiceId":{"type":"string","nullable":true},"displayName":{"type":"string","nullable":true},"givenName":{"type":"string","nullable":true},"sn":{"type":"string","nullable":true},"mail":{"type":"string","nullable":true},"workEmail":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"manager":{"type":"string","nullable":true},"managersEmail":{"type":"string","nullable":true},"managersName":{"type":"string","nullable":true},"managerIndividualContributor":{"type":"string","nullable":true},"isServiceAccount":{"type":"boolean","nullable":true},"serviceAccountEnvironment":{"type":"string","nullable":true},"usedExternally":{"type":"string","nullable":true},"employeeID":{"type":"string","nullable":true},"employeeType":{"type":"string","nullable":true},"workerType":{"type":"string","nullable":true},"workerStatus":{"type":"string","nullable":true},"workerJobLevel":{"type":"string","nullable":true},"businessCategory":{"type":"string","nullable":true},"costCenterUniqueId":{"type":"string","nullable":true},"anniversary":{"type":"string","nullable":true},"birthDate":{"type":"string","nullable":true},"whenCreated":{"type":"string","nullable":true},"telephoneNumber":{"type":"string","nullable":true},"physicalDeliveryOfficeName":{"type":"string","nullable":true},"seatingIDDisplayName":{"type":"string","nullable":true},"homeDirectory":{"type":"string","nullable":true},"loginShell":{"type":"string","nullable":true},"uidNumber":{"type":"string","nullable":true},"gidNumber":{"type":"string","nullable":true},"sshPublicKey":{"type":"string","nullable":true},"automationNote":{"type":"string","nullable":true},"importedFrom":{"type":"string","nullable":true},"memberOf":{"type":"array","items":{"type":"object","properties":{"group_name":{"type":"string"}},"required":["group_name"]}}},"required":["id","mode","isPublic","sAMAccountName","dssUsername","distinguishedName","employeeNumber","objectGUID","yellowpagesServiceId","displayName","givenName","sn","mail","workEmail","title","description","manager","managersEmail","managersName","managerIndividualContributor","isServiceAccount","serviceAccountEnvironment","usedExternally","employeeID","employeeType","workerType","workerStatus","workerJobLevel","businessCategory","costCenterUniqueId","anniversary","birthDate","whenCreated","telephoneNumber","physicalDeliveryOfficeName","seatingIDDisplayName","homeDirectory","loginShell","uidNumber","gidNumber","sshPublicKey","automationNote","importedFrom","memberOf"]}}}},"404":{"description":"User does not exist."}}}},"/api/ldap-sync-cache/user-by-yellowpages-service-id/{yellowpages_service_id}":{"get":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"yellowpages_service_id","in":"path"}],"responses":{"200":{"description":"Array of users matching the yellowpages service id.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"mode":{"type":"integer"},"isPublic":{"type":"boolean"},"sAMAccountName":{"type":"string","nullable":true},"dssUsername":{"type":"string","nullable":true},"distinguishedName":{"type":"string","nullable":true},"employeeNumber":{"type":"string","nullable":true},"objectGUID":{"type":"string","nullable":true},"yellowpagesServiceId":{"type":"string","nullable":true},"displayName":{"type":"string","nullable":true},"givenName":{"type":"string","nullable":true},"sn":{"type":"string","nullable":true},"mail":{"type":"string","nullable":true},"workEmail":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"manager":{"type":"string","nullable":true},"managersEmail":{"type":"string","nullable":true},"managersName":{"type":"string","nullable":true},"managerIndividualContributor":{"type":"string","nullable":true},"isServiceAccount":{"type":"boolean","nullable":true},"serviceAccountEnvironment":{"type":"string","nullable":true},"usedExternally":{"type":"string","nullable":true},"employeeID":{"type":"string","nullable":true},"employeeType":{"type":"string","nullable":true},"workerType":{"type":"string","nullable":true},"workerStatus":{"type":"string","nullable":true},"workerJobLevel":{"type":"string","nullable":true},"businessCategory":{"type":"string","nullable":true},"costCenterUniqueId":{"type":"string","nullable":true},"anniversary":{"type":"string","nullable":true},"birthDate":{"type":"string","nullable":true},"whenCreated":{"type":"string","nullable":true},"telephoneNumber":{"type":"string","nullable":true},"physicalDeliveryOfficeName":{"type":"string","nullable":true},"seatingIDDisplayName":{"type":"string","nullable":true},"homeDirectory":{"type":"string","nullable":true},"loginShell":{"type":"string","nullable":true},"uidNumber":{"type":"string","nullable":true},"gidNumber":{"type":"string","nullable":true},"sshPublicKey":{"type":"string","nullable":true},"automationNote":{"type":"string","nullable":true},"importedFrom":{"type":"string","nullable":true},"memberOf":{"type":"array","items":{"type":"object","properties":{"group_name":{"type":"string"}},"required":["group_name"]}}},"required":["id","mode","isPublic","sAMAccountName","dssUsername","distinguishedName","employeeNumber","objectGUID","yellowpagesServiceId","displayName","givenName","sn","mail","workEmail","title","description","manager","managersEmail","managersName","managerIndividualContributor","isServiceAccount","serviceAccountEnvironment","usedExternally","employeeID","employeeType","workerType","workerStatus","workerJobLevel","businessCategory","costCenterUniqueId","anniversary","birthDate","whenCreated","telephoneNumber","physicalDeliveryOfficeName","seatingIDDisplayName","homeDirectory","loginShell","uidNumber","gidNumber","sshPublicKey","automationNote","importedFrom","memberOf"]}}}}}}}},"/api/ldap-sync-cache/users":{"get":{"responses":{"200":{"description":"Array of all directory users.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"mode":{"type":"integer"},"isPublic":{"type":"boolean"},"sAMAccountName":{"type":"string","nullable":true},"dssUsername":{"type":"string","nullable":true},"distinguishedName":{"type":"string","nullable":true},"employeeNumber":{"type":"string","nullable":true},"objectGUID":{"type":"string","nullable":true},"yellowpagesServiceId":{"type":"string","nullable":true},"displayName":{"type":"string","nullable":true},"givenName":{"type":"string","nullable":true},"sn":{"type":"string","nullable":true},"mail":{"type":"string","nullable":true},"workEmail":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"manager":{"type":"string","nullable":true},"managersEmail":{"type":"string","nullable":true},"managersName":{"type":"string","nullable":true},"managerIndividualContributor":{"type":"string","nullable":true},"isServiceAccount":{"type":"boolean","nullable":true},"serviceAccountEnvironment":{"type":"string","nullable":true},"usedExternally":{"type":"string","nullable":true},"employeeID":{"type":"string","nullable":true},"employeeType":{"type":"string","nullable":true},"workerType":{"type":"string","nullable":true},"workerStatus":{"type":"string","nullable":true},"workerJobLevel":{"type":"string","nullable":true},"businessCategory":{"type":"string","nullable":true},"costCenterUniqueId":{"type":"string","nullable":true},"anniversary":{"type":"string","nullable":true},"birthDate":{"type":"string","nullable":true},"whenCreated":{"type":"string","nullable":true},"telephoneNumber":{"type":"string","nullable":true},"physicalDeliveryOfficeName":{"type":"string","nullable":true},"seatingIDDisplayName":{"type":"string","nullable":true},"homeDirectory":{"type":"string","nullable":true},"loginShell":{"type":"string","nullable":true},"uidNumber":{"type":"string","nullable":true},"gidNumber":{"type":"string","nullable":true},"sshPublicKey":{"type":"string","nullable":true},"automationNote":{"type":"string","nullable":true},"importedFrom":{"type":"string","nullable":true},"memberOf":{"type":"array","items":{"type":"object","properties":{"group_name":{"type":"string"}},"required":["group_name"]}}},"required":["id","mode","isPublic","sAMAccountName","dssUsername","distinguishedName","employeeNumber","objectGUID","yellowpagesServiceId","displayName","givenName","sn","mail","workEmail","title","description","manager","managersEmail","managersName","managerIndividualContributor","isServiceAccount","serviceAccountEnvironment","usedExternally","employeeID","employeeType","workerType","workerStatus","workerJobLevel","businessCategory","costCenterUniqueId","anniversary","birthDate","whenCreated","telephoneNumber","physicalDeliveryOfficeName","seatingIDDisplayName","homeDirectory","loginShell","uidNumber","gidNumber","sshPublicKey","automationNote","importedFrom","memberOf"]}}}}}}}},"/api/ldap-sync-cache/groups":{"get":{"responses":{"200":{"description":"Array of all directory groups with member counts.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"distinguishedName":{"type":"string"},"category":{"type":"string","nullable":true},"managedBy":{"type":"string","nullable":true},"dodgeballReadOnly":{"type":"boolean"},"yellowpagesServiceId":{"type":"string","nullable":true},"memberCount":{"type":"integer"}},"required":["name","distinguishedName","category","managedBy","dodgeballReadOnly","yellowpagesServiceId","memberCount"]}}}}}}}},"/api/ldap-sync-cache/search/users/{value}":{"get":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"value","in":"path"}],"responses":{"200":{"description":"Array of matching users.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"mode":{"type":"integer"},"isPublic":{"type":"boolean"},"sAMAccountName":{"type":"string","nullable":true},"dssUsername":{"type":"string","nullable":true},"distinguishedName":{"type":"string","nullable":true},"employeeNumber":{"type":"string","nullable":true},"objectGUID":{"type":"string","nullable":true},"yellowpagesServiceId":{"type":"string","nullable":true},"displayName":{"type":"string","nullable":true},"givenName":{"type":"string","nullable":true},"sn":{"type":"string","nullable":true},"mail":{"type":"string","nullable":true},"workEmail":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"manager":{"type":"string","nullable":true},"managersEmail":{"type":"string","nullable":true},"managersName":{"type":"string","nullable":true},"managerIndividualContributor":{"type":"string","nullable":true},"isServiceAccount":{"type":"boolean","nullable":true},"serviceAccountEnvironment":{"type":"string","nullable":true},"usedExternally":{"type":"string","nullable":true},"employeeID":{"type":"string","nullable":true},"employeeType":{"type":"string","nullable":true},"workerType":{"type":"string","nullable":true},"workerStatus":{"type":"string","nullable":true},"workerJobLevel":{"type":"string","nullable":true},"businessCategory":{"type":"string","nullable":true},"costCenterUniqueId":{"type":"string","nullable":true},"anniversary":{"type":"string","nullable":true},"birthDate":{"type":"string","nullable":true},"whenCreated":{"type":"string","nullable":true},"telephoneNumber":{"type":"string","nullable":true},"physicalDeliveryOfficeName":{"type":"string","nullable":true},"seatingIDDisplayName":{"type":"string","nullable":true},"homeDirectory":{"type":"string","nullable":true},"loginShell":{"type":"string","nullable":true},"uidNumber":{"type":"string","nullable":true},"gidNumber":{"type":"string","nullable":true},"sshPublicKey":{"type":"string","nullable":true},"automationNote":{"type":"string","nullable":true},"importedFrom":{"type":"string","nullable":true},"memberOf":{"type":"array","items":{"type":"object","properties":{"group_name":{"type":"string"}},"required":["group_name"]}}},"required":["id","mode","isPublic","sAMAccountName","dssUsername","distinguishedName","employeeNumber","objectGUID","yellowpagesServiceId","displayName","givenName","sn","mail","workEmail","title","description","manager","managersEmail","managersName","managerIndividualContributor","isServiceAccount","serviceAccountEnvironment","usedExternally","employeeID","employeeType","workerType","workerStatus","workerJobLevel","businessCategory","costCenterUniqueId","anniversary","birthDate","whenCreated","telephoneNumber","physicalDeliveryOfficeName","seatingIDDisplayName","homeDirectory","loginShell","uidNumber","gidNumber","sshPublicKey","automationNote","importedFrom","memberOf"]}}}}}}}},"/api/ldap-sync-cache/group/{name}":{"get":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"name","in":"path"}],"responses":{"200":{"description":"Group information with expanded members.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"mode":{"type":"integer"},"isPublic":{"type":"boolean"},"name":{"type":"string"},"distinguishedName":{"type":"string"},"category":{"type":"string","nullable":true},"managedBy":{"type":"string","nullable":true},"dodgeballReadOnly":{"type":"string","nullable":true},"yellowpagesServiceId":{"type":"string","nullable":true},"owner":{"type":"object","nullable":true,"properties":{"distinguishedName":{"type":"string","nullable":true},"objectClass":{"type":"string"},"sAMAccountName":{"type":"string"},"name":{"type":"string"}},"required":["distinguishedName","objectClass"]},"members":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"mode":{"type":"integer"},"isPublic":{"type":"boolean"},"sAMAccountName":{"type":"string","nullable":true},"dssUsername":{"type":"string","nullable":true},"distinguishedName":{"type":"string","nullable":true},"employeeNumber":{"type":"string","nullable":true},"objectGUID":{"type":"string","nullable":true},"yellowpagesServiceId":{"type":"string","nullable":true},"displayName":{"type":"string","nullable":true},"givenName":{"type":"string","nullable":true},"sn":{"type":"string","nullable":true},"mail":{"type":"string","nullable":true},"workEmail":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"manager":{"type":"string","nullable":true},"managersEmail":{"type":"string","nullable":true},"managersName":{"type":"string","nullable":true},"managerIndividualContributor":{"type":"string","nullable":true},"isServiceAccount":{"type":"boolean","nullable":true},"serviceAccountEnvironment":{"type":"string","nullable":true},"usedExternally":{"type":"string","nullable":true},"employeeID":{"type":"string","nullable":true},"employeeType":{"type":"string","nullable":true},"workerType":{"type":"string","nullable":true},"workerStatus":{"type":"string","nullable":true},"workerJobLevel":{"type":"string","nullable":true},"businessCategory":{"type":"string","nullable":true},"costCenterUniqueId":{"type":"string","nullable":true},"anniversary":{"type":"string","nullable":true},"birthDate":{"type":"string","nullable":true},"whenCreated":{"type":"string","nullable":true},"telephoneNumber":{"type":"string","nullable":true},"physicalDeliveryOfficeName":{"type":"string","nullable":true},"seatingIDDisplayName":{"type":"string","nullable":true},"homeDirectory":{"type":"string","nullable":true},"loginShell":{"type":"string","nullable":true},"uidNumber":{"type":"string","nullable":true},"gidNumber":{"type":"string","nullable":true},"sshPublicKey":{"type":"string","nullable":true},"automationNote":{"type":"string","nullable":true},"importedFrom":{"type":"string","nullable":true},"memberOf":{"type":"array","items":{"type":"object","properties":{"group_name":{"type":"string"}},"required":["group_name"]}}},"required":["id","mode","isPublic","sAMAccountName","dssUsername","distinguishedName","employeeNumber","objectGUID","yellowpagesServiceId","displayName","givenName","sn","mail","workEmail","title","description","manager","managersEmail","managersName","managerIndividualContributor","isServiceAccount","serviceAccountEnvironment","usedExternally","employeeID","employeeType","workerType","workerStatus","workerJobLevel","businessCategory","costCenterUniqueId","anniversary","birthDate","whenCreated","telephoneNumber","physicalDeliveryOfficeName","seatingIDDisplayName","homeDirectory","loginShell","uidNumber","gidNumber","sshPublicKey","automationNote","importedFrom","memberOf"]}}},"required":["id","mode","isPublic","name","distinguishedName","category","managedBy","dodgeballReadOnly","yellowpagesServiceId","owner","members"]}}}},"404":{"description":"Group does not exist."}}}},"/api/service-accounts":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"role":{"type":"string","enum":["org:admin","org:contributor","org:viewer","ci:agent"]},"expiresInDays":{"type":"integer","minimum":0,"exclusiveMinimum":true}},"required":["name"]}}}},"responses":{"201":{"description":"Service account created. The raw token is returned exactly once.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"token":{"type":"string"},"role":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":"string","nullable":true}},"required":["id","name","token","role","createdAt","expiresAt"]}}}},"400":{"description":"Invalid request body."}}},"get":{"responses":{"200":{"description":"List of service accounts (metadata only — no tokens or hashes).","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"createdAt":{"type":"string"},"lastUsedAt":{"type":"string","nullable":true},"expiresAt":{"type":"string","nullable":true}},"required":["id","name","role","createdAt","lastUsedAt","expiresAt"]}}}}}}}},"/api/service-accounts/{id}":{"delete":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"Service account deleted."},"404":{"description":"Service account not found or does not belong to caller org."}}}},"/api/org-members/pending":{"get":{"responses":{"200":{"description":"Portal users with no role in the caller org.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"name":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","email","name","createdAt"]}}}}}}}},"/api/org-members/grant":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","minLength":1},"role":{"type":"string","enum":["org:admin","org:contributor","org:viewer","ci:agent"]}},"required":["userId","role"]}}}},"responses":{"200":{"description":"Role granted (created or updated).","content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"orgId":{"type":"string"},"role":{"type":"string"}},"required":["userId","orgId","role"]}}}},"400":{"description":"Invalid request body, or role is not a grantable org role."},"404":{"description":"No such user."}}}},"/api/webhooks":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"events":{"type":"array","items":{"type":"string"}},"secret":{"type":"string"}},"required":["url"]}}}},"responses":{"201":{"description":"Webhook created. Secret returned only on create.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"active":{"type":"boolean"},"secret":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","url","events","active","secret","createdAt","updatedAt"]}}}},"400":{"description":"Invalid URL (SSRF blocked) or bad request."},"403":{"description":"Forbidden — requires org:admin."}}},"get":{"responses":{"200":{"description":"List of webhooks for the caller org.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"active":{"type":"boolean"},"secret":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","url","events","active","createdAt","updatedAt"]}}}}},"403":{"description":"Forbidden — requires org:admin."}}}},"/api/webhooks/{id}/deliveries":{"get":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Recent deliveries for this webhook.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventType":{"type":"string"},"status":{"type":"string"},"attemptCount":{"type":"number"},"responseStatus":{"type":"number","nullable":true},"lastError":{"type":"string","nullable":true},"createdAt":{"type":"string"}},"required":["id","eventType","status","attemptCount","responseStatus","lastError","createdAt"]}}}}},"404":{"description":"Webhook not found."}}}},"/api/webhooks/{id}":{"patch":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"events":{"type":"array","items":{"type":"string"}},"active":{"type":"boolean"},"rotateSecret":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Updated webhook. Includes plaintext `secret` **once** when rotateSecret=true.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"active":{"type":"boolean"},"secret":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","url","events","active","createdAt","updatedAt"]}}}},"400":{"description":"Invalid URL (SSRF blocked)."},"404":{"description":"Webhook not found."}}},"delete":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"Webhook deleted."},"404":{"description":"Webhook not found."}}}},"/api/webhooks/{id}/test":{"post":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Test event emitted and delivery attempted."},"404":{"description":"Webhook not found."}}}},"/api/sync/sources":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"kind":{"type":"string","enum":["ldap","ad","workday","scim","native"]},"config":{"nullable":true},"secret":{"type":"string"}},"required":["name","kind"]}}}},"responses":{"201":{"description":"Sync source created.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"config":{"type":"object","additionalProperties":{"nullable":true}},"active":{"type":"boolean"},"lastRunAt":{"type":"string","nullable":true},"lastStatus":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","kind","config","active","lastRunAt","lastStatus","createdAt","updatedAt"]}}}},"400":{"description":"Invalid kind or bad request."},"403":{"description":"Forbidden — requires org:admin."}}},"get":{"responses":{"200":{"description":"List of sync sources (secretEnc never returned).","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"config":{"type":"object","additionalProperties":{"nullable":true}},"active":{"type":"boolean"},"lastRunAt":{"type":"string","nullable":true},"lastStatus":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","kind","config","active","lastRunAt","lastStatus","createdAt","updatedAt"]}}}}},"403":{"description":"Forbidden — requires org:admin."}}}},"/api/sync/sources/{id}/runs":{"get":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Recent sync runs.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"usersUpserted":{"type":"number"},"groupsUpserted":{"type":"number"},"usersSoftDeleted":{"type":"number"},"error":{"type":"string","nullable":true},"startedAt":{"type":"string"},"finishedAt":{"type":"string","nullable":true}},"required":["id","status","usersUpserted","groupsUpserted","usersSoftDeleted","error","startedAt","finishedAt"]}}}}},"404":{"description":"Source not found."}}}},"/api/sync/sources/{id}":{"patch":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"config":{"nullable":true},"secret":{"type":"string"},"active":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Updated sync source.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"config":{"type":"object","additionalProperties":{"nullable":true}},"active":{"type":"boolean"},"lastRunAt":{"type":"string","nullable":true},"lastStatus":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","kind","config","active","lastRunAt","lastStatus","createdAt","updatedAt"]}}}},"404":{"description":"Source not found."}}},"delete":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"Sync source deleted."},"404":{"description":"Source not found."}}}},"/api/sync/sources/{id}/run":{"post":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Sync run result.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"usersUpserted":{"type":"number"},"groupsUpserted":{"type":"number"},"usersSoftDeleted":{"type":"number"},"error":{"type":"string","nullable":true},"startedAt":{"type":"string"},"finishedAt":{"type":"string","nullable":true}},"required":["id","status","usersUpserted","groupsUpserted","usersSoftDeleted","error","startedAt","finishedAt"]}}}},"404":{"description":"Source not found."},"501":{"description":"Source kind not yet implemented."}}}},"/api/access/targets":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"provider":{"type":"string","enum":["github","azure_devops","gitlab","fleetworks"]},"config":{"nullable":true},"secret":{"type":"string"},"active":{"type":"boolean"},"enforcement":{"type":"string","enum":["report_only","additive","full"]}},"required":["name","provider"]}}}},"responses":{"201":{"description":"Access target created.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"orgId":{"type":"string"},"provider":{"type":"string"},"name":{"type":"string"},"config":{"nullable":true},"active":{"type":"boolean"},"enforcement":{"type":"string"},"lastRunAt":{"type":"string","nullable":true},"lastStatus":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","orgId","provider","name","active","enforcement","lastRunAt","lastStatus","createdAt","updatedAt"]}}}},"400":{"description":"Invalid provider or bad request."}}},"get":{"responses":{"200":{"description":"List of access targets.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"orgId":{"type":"string"},"provider":{"type":"string"},"name":{"type":"string"},"config":{"nullable":true},"active":{"type":"boolean"},"enforcement":{"type":"string"},"lastRunAt":{"type":"string","nullable":true},"lastStatus":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","orgId","provider","name","active","enforcement","lastRunAt","lastStatus","createdAt","updatedAt"]}}}}}}}},"/api/access/targets/{id}":{"get":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Access target.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"orgId":{"type":"string"},"provider":{"type":"string"},"name":{"type":"string"},"config":{"nullable":true},"active":{"type":"boolean"},"enforcement":{"type":"string"},"lastRunAt":{"type":"string","nullable":true},"lastStatus":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","orgId","provider","name","active","enforcement","lastRunAt","lastStatus","createdAt","updatedAt"]}}}},"404":{"description":"Not found."}}},"patch":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"config":{"nullable":true},"secret":{"type":"string"},"active":{"type":"boolean"},"enforcement":{"type":"string","enum":["report_only","additive","full"]}}}}}},"responses":{"200":{"description":"Updated access target.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"orgId":{"type":"string"},"provider":{"type":"string"},"name":{"type":"string"},"config":{"nullable":true},"active":{"type":"boolean"},"enforcement":{"type":"string"},"lastRunAt":{"type":"string","nullable":true},"lastStatus":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","orgId","provider","name","active","enforcement","lastRunAt","lastStatus","createdAt","updatedAt"]}}}},"404":{"description":"Not found."}}},"delete":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"Target deleted."},"404":{"description":"Not found."}}}},"/api/access/targets/{id}/reconcile":{"post":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Reconcile result.","content":{"application/json":{"schema":{"nullable":true}}}},"404":{"description":"Target not found."},"501":{"description":"Provider not yet implemented."}}}},"/api/access/targets/{id}/runs":{"get":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Run history.","content":{"application/json":{"schema":{"nullable":true}}}},"404":{"description":"Target not found."}}}},"/api/access/bindings":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"rolodexGroupId":{"type":"string"},"targetId":{"type":"string"},"externalTarget":{"type":"string"},"role":{"type":"string"},"active":{"type":"boolean"}},"required":["rolodexGroupId","targetId","externalTarget","role"]}}}},"responses":{"201":{"description":"Access binding created.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"rolodexGroupId":{"type":"string"},"targetId":{"type":"string"},"externalTarget":{"type":"string"},"role":{"type":"string"},"active":{"type":"boolean"},"previewed":{"type":"boolean"},"confirmedBy":{"type":"string","nullable":true},"confirmedAt":{"type":"string","nullable":true},"createdBy":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","rolodexGroupId","targetId","externalTarget","role","active","previewed","confirmedBy","confirmedAt","createdBy","createdAt","updatedAt"]}}}},"400":{"description":"No org, or invalid role for the target provider."},"404":{"description":"Target not found in the caller org."}}},"get":{"responses":{"200":{"description":"List of access bindings.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"rolodexGroupId":{"type":"string"},"targetId":{"type":"string"},"externalTarget":{"type":"string"},"role":{"type":"string"},"active":{"type":"boolean"},"previewed":{"type":"boolean"},"confirmedBy":{"type":"string","nullable":true},"confirmedAt":{"type":"string","nullable":true},"createdBy":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","rolodexGroupId","targetId","externalTarget","role","active","previewed","confirmedBy","confirmedAt","createdBy","createdAt","updatedAt"]}}}}}}}},"/api/access/bindings/{id}":{"get":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Access binding.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"rolodexGroupId":{"type":"string"},"targetId":{"type":"string"},"externalTarget":{"type":"string"},"role":{"type":"string"},"active":{"type":"boolean"},"previewed":{"type":"boolean"},"confirmedBy":{"type":"string","nullable":true},"confirmedAt":{"type":"string","nullable":true},"createdBy":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","rolodexGroupId","targetId","externalTarget","role","active","previewed","confirmedBy","confirmedAt","createdBy","createdAt","updatedAt"]}}}},"404":{"description":"Not found."}}},"patch":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"externalTarget":{"type":"string"},"role":{"type":"string"},"active":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Updated binding.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"rolodexGroupId":{"type":"string"},"targetId":{"type":"string"},"externalTarget":{"type":"string"},"role":{"type":"string"},"active":{"type":"boolean"},"previewed":{"type":"boolean"},"confirmedBy":{"type":"string","nullable":true},"confirmedAt":{"type":"string","nullable":true},"createdBy":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","rolodexGroupId","targetId","externalTarget","role","active","previewed","confirmedBy","confirmedAt","createdBy","createdAt","updatedAt"]}}}},"400":{"description":"Invalid role for the target provider."},"404":{"description":"Not found."}}},"delete":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"Binding deleted."},"404":{"description":"Not found."}}}},"/api/access/bindings/{id}/confirm":{"post":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Binding confirmed.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"rolodexGroupId":{"type":"string"},"targetId":{"type":"string"},"externalTarget":{"type":"string"},"role":{"type":"string"},"active":{"type":"boolean"},"previewed":{"type":"boolean"},"confirmedBy":{"type":"string","nullable":true},"confirmedAt":{"type":"string","nullable":true},"createdBy":{"type":"string","nullable":true},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","rolodexGroupId","targetId","externalTarget","role","active","previewed","confirmedBy","confirmedAt","createdBy","createdAt","updatedAt"]}}}},"403":{"description":"The creator of a binding may not confirm it."},"404":{"description":"Not found."}}}},"/api/access/identities/import":{"post":{"requestBody":{"content":{"text/csv":{"schema":{"type":"string"}},"application/json":{"schema":{"type":"object","properties":{"csv":{"type":"string"}},"required":["csv"]}}}},"responses":{"200":{"description":"Import result.","content":{"application/json":{"schema":{"nullable":true}}}},"400":{"description":"Invalid CSV."}}}},"/api/access/identities/fleetworks/propose":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","minLength":1}},"required":["email"]}}}},"responses":{"200":{"description":"Candidate directory rows. Nothing was linked.","content":{"application/json":{"schema":{"nullable":true}}}}}}},"/api/access/identities/fleetworks/link":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"projectRef":{"type":"string","minLength":1},"externalPrincipal":{"type":"string","minLength":1},"objectGuid":{"type":"string"},"distinguishedName":{"type":"string"}},"required":["projectRef","externalPrincipal"]}}}},"responses":{"200":{"description":"Linked.","content":{"application/json":{"schema":{"nullable":true}}}},"400":{"description":"No usable anchor, or the row is a departure tombstone."}}}},"/api/directory/users/{id}/mode":{"patch":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"integer"}},"required":["mode"]}}}},"responses":{"200":{"description":"Updated resource permission mode.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"mode":{"type":"number"},"is_public":{"type":"boolean"}},"required":["id","mode","is_public"]}}}},"400":{"description":"Invalid mode.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/api/directory/groups/{id}/mode":{"patch":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"integer"}},"required":["mode"]}}}},"responses":{"200":{"description":"Updated resource permission mode.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"mode":{"type":"number"},"is_public":{"type":"boolean"}},"required":["id","mode","is_public"]}}}},"400":{"description":"Invalid mode.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/api/directory/users":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userName":{"type":"string","minLength":1},"displayName":{"type":"string","nullable":true},"givenName":{"type":"string","nullable":true},"sn":{"type":"string","nullable":true},"mail":{"type":"string","nullable":true,"format":"email"},"title":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"telephoneNumber":{"type":"string","nullable":true},"employeeType":{"type":"string","nullable":true}},"required":["userName"]}}}},"responses":{"201":{"description":"Native directory user created.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"objectGuid":{"type":"string","nullable":true},"distinguishedName":{"type":"string","nullable":true},"sAMAccountName":{"type":"string","nullable":true},"displayName":{"type":"string","nullable":true},"mail":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"workerStatus":{"type":"string","nullable":true},"importedFrom":{"type":"string","nullable":true},"mode":{"type":"number"}},"required":["id","objectGuid","distinguishedName","sAMAccountName","displayName","mail","title","workerStatus","importedFrom","mode"]}}}},"409":{"description":"sAMAccountName already in use.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/api/directory/users/{id}":{"patch":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userName":{"type":"string","minLength":1},"displayName":{"type":"string","nullable":true},"givenName":{"type":"string","nullable":true},"sn":{"type":"string","nullable":true},"mail":{"type":"string","nullable":true,"format":"email"},"title":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"telephoneNumber":{"type":"string","nullable":true},"employeeType":{"type":"string","nullable":true}}}}}},"responses":{"200":{"description":"Updated native directory user.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"objectGuid":{"type":"string","nullable":true},"distinguishedName":{"type":"string","nullable":true},"sAMAccountName":{"type":"string","nullable":true},"displayName":{"type":"string","nullable":true},"mail":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"workerStatus":{"type":"string","nullable":true},"importedFrom":{"type":"string","nullable":true},"mode":{"type":"number"}},"required":["id","objectGuid","distinguishedName","sAMAccountName","displayName","mail","title","workerStatus","importedFrom","mode"]}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"409":{"description":"Row is not native, or sAMAccountName already in use.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"User deprovisioned (worker_status = Inactive).","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"objectGuid":{"type":"string","nullable":true},"distinguishedName":{"type":"string","nullable":true},"sAMAccountName":{"type":"string","nullable":true},"displayName":{"type":"string","nullable":true},"mail":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"workerStatus":{"type":"string","nullable":true},"importedFrom":{"type":"string","nullable":true},"mode":{"type":"number"}},"required":["id","objectGuid","distinguishedName","sAMAccountName","displayName","mail","title","workerStatus","importedFrom","mode"]}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"409":{"description":"Row is not native.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/api/directory/groups":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"category":{"type":"string","nullable":true},"managedBy":{"type":"string","nullable":true}},"required":["name"]}}}},"responses":{"201":{"description":"Native directory group created.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"distinguishedName":{"type":"string"},"category":{"type":"string","nullable":true},"managedBy":{"type":"string","nullable":true},"mode":{"type":"number"}},"required":["id","name","distinguishedName","category","managedBy","mode"]}}}},"409":{"description":"Group name already in use.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/api/directory/groups/{id}":{"patch":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"category":{"type":"string","nullable":true},"managedBy":{"type":"string","nullable":true}}}}}},"responses":{"200":{"description":"Updated native directory group.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"distinguishedName":{"type":"string"},"category":{"type":"string","nullable":true},"managedBy":{"type":"string","nullable":true},"mode":{"type":"number"}},"required":["id","name","distinguishedName","category","managedBy","mode"]}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"409":{"description":"Group is not native, or name already in use.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/api/directory/groups/{id}/members":{"post":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","minLength":1}},"required":["userId"]}}}},"responses":{"200":{"description":"Member present in the group.","content":{"application/json":{"schema":{"type":"object","properties":{"groupId":{"type":"string"},"userId":{"type":"string"},"member":{"type":"boolean"},"changed":{"type":"boolean"}},"required":["groupId","userId","member","changed"]}}}},"404":{"description":"Group or user not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"409":{"description":"Group is not native.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/api/directory/groups/{id}/members/{userId}":{"delete":{"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"userId","in":"path"}],"responses":{"200":{"description":"Member absent from the group.","content":{"application/json":{"schema":{"type":"object","properties":{"groupId":{"type":"string"},"userId":{"type":"string"},"member":{"type":"boolean"},"changed":{"type":"boolean"}},"required":["groupId","userId","member","changed"]}}}},"404":{"description":"Group not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"409":{"description":"Group is not native.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}}}}