openapi-directory/api/rumble.run.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","servers":[{"description":"Rumble Console","url":"https://console.rumble.run/api/v1.0"}],"info":{"contact":{"email":"support@runzero.com"},"description":"<p><b><i>Rumble Network Discovery is now runZero. <a href=\"https://www.runzero.com/blog/introducing-runzero/\">Read the announcement</a></i></b>.</p> <p>This API is frozen and no longer being updated as of version 2.15.0.</p> <p>See our latest API documentation at <a href=\"https://app.swaggerhub.com/apis-docs/runZero/runZero\">swaggerhub.com/apis-docs/runZero/runZero</a>.</p>\n","license":{"name":"Commercial","url":"https://www.runzero.com/legal/terms"},"title":"Rumble API (deprecated)","version":"2.15.0","x-apisguru-categories":["monitoring"],"x-logo":{"url":"//www.rumble.run/img/rumble-twitter-card.png"},"x-origin":[{"format":"openapi","url":"https://raw.githubusercontent.com/RumbleDiscovery/rumble-api/main/rumble-api.yml","version":"3.0"}],"x-providerName":"rumble.run"},"tags":[{"description":"Requires Organization Key","name":"Organization"},{"description":"Requires Export Token or Organization Key","name":"Export"},{"description":"Unauthenticated","name":"Public"}],"paths":{"/account/agents":{"get":{"operationId":"getAccountAgents","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Agent"},"type":"array"}}},"description":"array of tasks"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get all agents across all organizations","tags":["Account"]}},"/account/credentials":{"get":{"operationId":"getAccountCredentials","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Credential"},"type":"array"}}},"description":"array of credentials"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get all account credentials","tags":["Account"]},"put":{"operationId":"createAccountCredential","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialOptions"}}},"description":"credential parameters","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Credential"}}},"description":"credential details"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Create a new credential","tags":["Account"]}},"/account/credentials/{credential_id}":{"delete":{"operationId":"removeAccountCredential","parameters":[{"description":"UUID of the credential to delete","in":"path","name":"credential_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"204":{"description":"empty response"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Remove this credential","tags":["Account"]},"get":{"operationId":"getAccountCredential","parameters":[{"description":"UUID of the credential to retrieve","in":"path","name":"credential_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Credential"}}},"description":"credential details"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Get credential details","tags":["Account"]}},"/account/events.json":{"get":{"operationId":"exportEventsJSON","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}},{"description":"an optional list of fields to export, comma-separated","in":"query","name":"fields","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Event"},"type":"array"}}},"description":"filtered event results"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"System event log as JSON","tags":["Account"]}},"/account/events.jsonl":{"get":{"operationId":"exportEventsJSONL","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}},{"description":"an optional list of fields to export, comma-separated","in":"query","name":"fields","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Event"},"type":"array"}}},"description":"filtered event results"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"System event log as JSON line-delimited","tags":["Account"]}},"/account/groups":{"get":{"operationId":"getAccountGroups","responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Group"}}},"description":"Automatically created"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get all groups","tags":["Account"]},"post":{"operationId":"createAccountGroup","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupPost"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Group"}}},"description":"Automatically created"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Create a new group","tags":["Account"]},"put":{"operationId":"updateAccountGroup","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupPut"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Group"}}},"description":"Automatically created"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Update an existing group","tags":["Account"]}},"/account/groups/{group_id}":{"delete":{"operationId":"removeAccountGroup","responses":{"204":{"description":"empty response"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Remove this group","tags":["Account"]},"get":{"operationId":"getAccountGroup","responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Group"}}},"description":"Automatically created"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Get group details","tags":["Account"]},"parameters":[{"description":"UUID of the group","in":"path","name":"group_id","required":true,"schema":{"format":"uuid","type":"string"}}]},"/account/keys":{"get":{"operationId":"getAccountKeys","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/APIKey"},"type":"array"}}},"description":"array of keys"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get all active API keys","tags":["Account"]},"put":{"operationId":"createAccountKey","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyOptions"}}},"description":"key parameters","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKey"}}},"description":"key details"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Create a new key","tags":["Account"]}},"/account/keys/{key_id}":{"delete":{"operationId":"removeAccountKey","parameters":[{"description":"UUID of the key to retrieve","in":"path","name":"key_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"204":{"description":"empty response"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Remove this key","tags":["Account"]},"get":{"operationId":"getAccountKey","parameters":[{"description":"UUID of the key to retrieve","in":"path","name":"key_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/APIKey"}}},"description":"Automatically created"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get key details","tags":["Account"]}},"/account/keys/{key_id}/rotate":{"patch":{"operationId":"rotateAccountKey","parameters":[{"description":"UUID of the key to retrieve","in":"path","name":"key_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKey"}}},"description":"key details"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Rotates the key secret","tags":["Account"]}},"/account/license":{"get":{"operationId":"getAccountLicense","responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/License"}}},"description":"Automatically created"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get license details","tags":["Account"]}},"/account/orgs":{"get":{"operationId":"getAccountOrganizations","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Organization"},"type":"array"}}},"description":"array of organizations"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get all organization details","tags":["Account"]},"put":{"operationId":"createAccountOrganization","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgOptions"}}},"description":"organization definition","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}},"description":"organization details"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Create a new organization","tags":["Account"]}},"/account/orgs/{org_id}":{"delete":{"operationId":"removeAccountOrganization","parameters":[{"description":"UUID of the organization to retrieve","in":"path","name":"org_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"204":{"description":"empty response"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Remove this organization","tags":["Account"]},"get":{"operationId":"getAccountOrganization","parameters":[{"description":"UUID of the organization to retrieve","in":"path","name":"org_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Organization"}}},"description":"Automatically created"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get organization details","tags":["Account"]},"patch":{"operationId":"updateAccountOrganization","parameters":[{"description":"UUID of the organization to retrieve","in":"path","name":"org_id","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgOptions"}}},"description":"organization options","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}},"description":"organization details"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Update organization details","tags":["Account"]}},"/account/orgs/{org_id}/exportToken":{"delete":{"operationId":"deleteAccountOrganizationExportToken","parameters":[{"description":"UUID of the organization to retrieve","in":"path","name":"org_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"204":{"description":"empty response"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Removes the export token from the specified organization","tags":["Account"]}},"/account/orgs/{org_id}/exportToken/rotate":{"patch":{"operationId":"rotateAccountOrganizationExportToken","parameters":[{"description":"UUID of the organization to retrieve","in":"path","name":"org_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}},"description":"organization details"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Rotates the organization export token and returns the updated organization","tags":["Account"]}},"/account/sites":{"get":{"operationId":"getAccountSites","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Site"},"type":"array"}}},"description":"array of sites"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get all sites details across all organizations","tags":["Account"]}},"/account/sso/groups":{"get":{"operationId":"getAccountGroupMappings","responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/GroupMapping"}}},"description":"Automatically created"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get all SSO group mappings","tags":["Account"]},"post":{"operationId":"createAccountGroupMapping","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupMapping"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/GroupMapping"}}},"description":"Automatically created"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Create a new SSO group mapping","tags":["Account"]},"put":{"operationId":"updateAccountGroupMapping","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupMapping"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/GroupMapping"}}},"description":"Automatically created"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Update an existing SSO group mapping","tags":["Account"]}},"/account/sso/groups/{group_mapping_id}":{"delete":{"operationId":"removeAccountGroupMapping","responses":{"204":{"description":"empty response"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Remove this SSO group mapping","tags":["Account"]},"get":{"operationId":"getAccountGroupMapping","responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/GroupMapping"}}},"description":"Automatically created"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Get SSO group mapping details","tags":["Account"]},"parameters":[{"description":"UUID of the SSO group mapping","in":"path","name":"group_mapping_id","required":true,"schema":{"format":"uuid","type":"string"}}]},"/account/tasks":{"get":{"operationId":"getAccountTasks","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Task"},"type":"array"}}},"description":"array of tasks"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get all task details across all organizations (up to 1000)","tags":["Account"]}},"/account/tasks/templates":{"get":{"operationId":"getAccountScanTemplates","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ScanTemplate"},"type":"array"}}},"description":"array of scan templates"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"422":{"description":"failed to parse search string"}},"security":[{"bearerAuth":[]}],"summary":"Get all scan templates across all organizations (up to 1000)","tags":["Account"]},"post":{"operationId":"createAccountScanTemplate","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanTemplateOptions"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanTemplate"}}},"description":"scan template"},"400":{"description":"invalid request body"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"422":{"description":"invalid request body"}},"security":[{"bearerAuth":[]}],"summary":"Create a new scan template","tags":["Account"]},"put":{"operationId":"updateAccountScanTemplate","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanTemplate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanTemplate"}}},"description":"scan template"},"400":{"description":"invalid request body"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"description":"scan template or permissions not found"},"422":{"description":"invalid request body"}},"security":[{"bearerAuth":[]}],"summary":"Update scan template","tags":["Account"]}},"/account/tasks/templates/{scan_template_id}":{"delete":{"operationId":"removeAccountScanTemplate","parameters":[{"description":"UUID of the scan template to remove","in":"path","name":"scan_template_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanTemplate"}}},"description":"scan template"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"description":"scan template not found"},"422":{"description":"invalid request"}},"security":[{"bearerAuth":[]}],"summary":"Remove scan template","tags":["Account"]},"get":{"operationId":"getAccountScanTemplate","parameters":[{"description":"UUID of the scan template to retrieve","in":"path","name":"scan_template_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanTemplate"}}},"description":"scan template"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"description":"scan template not found"},"422":{"description":"invalid scan template id"}},"security":[{"bearerAuth":[]}],"summary":"Get scan template details","tags":["Account"]}},"/account/users":{"get":{"operationId":"getAccountUsers","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/User"},"type":"array"}}},"description":"array of users"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get all users","tags":["Account"]},"put":{"operationId":"createAccountUser","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOptions"}}},"description":"user parameters","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}},"description":"key details"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Create a new user account","tags":["Account"]}},"/account/users/invite":{"put":{"operationId":"createAccountUserInvite","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserInviteOptions"}}},"description":"user invite parameters","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}},"description":"key details"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Create a new user account and send an email invite","tags":["Account"]}},"/account/users/{user_id}":{"delete":{"operationId":"removeAccountUser","parameters":[{"description":"UUID of the user to delete","in":"path","name":"user_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"204":{"description":"empty response"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Remove this user","tags":["Account"]},"get":{"operationId":"getAccountUser","parameters":[{"description":"UUID of the user to retrieve","in":"path","name":"user_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/User"}}},"description":"Automatically created"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get user details","tags":["Account"]},"patch":{"operationId":"updateAccountUser","parameters":[{"description":"UUID of the user to retrieve","in":"path","name":"user_id","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOptions"}}},"description":"user parameters","required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/User"}}},"description":"Automatically created"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Update a user's details","tags":["Account"]}},"/account/users/{user_id}/resetLockout":{"patch":{"operationId":"resetAccountUserLockout","parameters":[{"description":"UUID of the user to retrieve","in":"path","name":"user_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/User"}}},"description":"Automatically created"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Resets the user's lockout status","tags":["Account"]}},"/account/users/{user_id}/resetMFA":{"patch":{"operationId":"resetAccountUserMFA","parameters":[{"description":"UUID of the user to retrieve","in":"path","name":"user_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/User"}}},"description":"Automatically created"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Resets the user's MFA tokens","tags":["Account"]}},"/account/users/{user_id}/resetPassword":{"patch":{"operationId":"resetAccountUserPassword","parameters":[{"description":"UUID of the user to retrieve","in":"path","name":"user_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/User"}}},"description":"Automatically created"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Sends the user a password reset email","tags":["Account"]}},"/export/org/assets.cisco.csv":{"get":{"operationId":"exportAssetsCiscoCSV","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"filtered asset results"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Cisco serial number and model name export for Cisco Smart Net Total Care Service.","tags":["Cisco SNTC"]}},"/export/org/assets.csv":{"get":{"operationId":"exportAssetsCSV","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"filtered asset results"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Asset inventory as CSV","tags":["Export"]}},"/export/org/assets.json":{"get":{"operationId":"exportAssetsJSON","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}},{"description":"an optional list of fields to export, comma-separated","in":"query","name":"fields","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Asset"},"type":"array"}}},"description":"filtered asset results"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Exports the asset inventory","tags":["Export"]}},"/export/org/assets.jsonl":{"get":{"operationId":"exportAssetsJSONL","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}},{"description":"an optional list of fields to export, comma-separated","in":"query","name":"fields","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"format":"binary","type":"string"}}},"description":"filtered asset results"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Asset inventory as JSON line-delimited","tags":["Export"]}},"/export/org/assets.nmap.xml":{"get":{"operationId":"exportAssetsNmapXML","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/xml":{"schema":{"format":"binary","type":"string"}}},"description":"filtered asset results"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Asset inventory as Nmap-style XML","tags":["Export"]}},"/export/org/assets.servicenow.csv":{"get":{"operationId":"snowExportAssetsCSV","responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"asset export"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Export an asset inventory as CSV for ServiceNow integration","tags":["ServiceNow"]}},"/export/org/assets.servicenow.json":{"get":{"operationId":"snowExportAssetsJSON","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AssetServiceNow"},"type":"array"}}},"description":"filtered asset results"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Exports the asset inventory as JSON","tags":["ServiceNow"]}},"/export/org/assets/sync/created/assets.json":{"get":{"operationId":"splunkAssetSyncCreatedJSON","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}},{"description":"an optional list of fields to export, comma-separated","in":"query","name":"fields","required":false,"schema":{"type":"string"}},{"description":"an optional unix timestamp to use as a checkpoint","in":"query","name":"since","required":false,"schema":{"example":1576300370,"format":"int64","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetsWithCheckpoint"}}},"description":"filtered asset results with a checkpoint wrapper"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Exports the asset inventory in a sync-friendly manner using created_at as a checkpoint. Requires the Splunk entitlement.","tags":["Splunk"]}},"/export/org/assets/sync/updated/assets.json":{"get":{"operationId":"splunkAssetSyncUpdatedJSON","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}},{"description":"an optional list of fields to export, comma-separated","in":"query","name":"fields","required":false,"schema":{"type":"string"}},{"description":"an optional unix timestamp to use as a checkpoint","in":"query","name":"since","required":false,"schema":{"example":1576300370,"format":"int64","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetsWithCheckpoint"}}},"description":"filtered asset results with a checkpoint wrapper"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Exports the asset inventory in a sync-friendly manner using updated_at as a checkpoint. Requires the Splunk entitlement.","tags":["Splunk"]}},"/export/org/services.csv":{"get":{"operationId":"exportServicesCSV","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"filtered service results"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Service inventory as CSV","tags":["Export"]}},"/export/org/services.json":{"get":{"operationId":"exportServicesJSON","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}},{"description":"an optional list of fields to export, comma-separated","in":"query","name":"fields","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Service"},"type":"array"}}},"description":"filtered service results"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Service inventory as JSON","tags":["Export"]}},"/export/org/services.jsonl":{"get":{"operationId":"exportServicesJSONL","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}},{"description":"an optional list of fields to export, comma-separated","in":"query","name":"fields","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"format":"binary","type":"string"}}},"description":"filtered service results"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Service inventory as JSON line-delimited","tags":["Export"]}},"/export/org/services.servicenow.csv":{"get":{"operationId":"snowExportServicesCSV","responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"services export"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Export a service inventory as CSV for ServiceNow integration","tags":["ServiceNow"]}},"/export/org/sites.csv":{"get":{"operationId":"exportSitesCSV","responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"all sites"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Site list as CSV","tags":["Export"]}},"/export/org/sites.json":{"get":{"operationId":"exportSitesJSON","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}},{"description":"an optional list of fields to export, comma-separated","in":"query","name":"fields","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Site"},"type":"array"}}},"description":"all sites"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Export all sites","tags":["Export"]}},"/export/org/sites.jsonl":{"get":{"operationId":"exportSitesJSONL","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}},{"description":"an optional list of fields to export, comma-separated","in":"query","name":"fields","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"format":"binary","type":"string"}}},"description":"all sites"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Site list as JSON line-delimited","tags":["Export"]}},"/export/org/wireless.csv":{"get":{"operationId":"exportWirelessCSV","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"filtered wireless results"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Wireless inventory as CSV","tags":["Export"]}},"/export/org/wireless.json":{"get":{"operationId":"exportWirelessJSON","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}},{"description":"an optional list of fields to export, comma-separated","in":"query","name":"fields","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Wireless"},"type":"array"}}},"description":"filtered wireless results"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Wireless inventory as JSON","tags":["Export"]}},"/export/org/wireless.jsonl":{"get":{"operationId":"exportWirelessJSONL","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}},{"description":"an optional list of fields to export, comma-separated","in":"query","name":"fields","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"format":"binary","type":"string"}}},"description":"filtered wireless results"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Wireless inventory as JSON line-delimited","tags":["Export"]}},"/org":{"get":{"operationId":"getOrganization","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}},"description":"organization details"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get organization details","tags":["Organization"]},"patch":{"operationId":"updateOrganization","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgOptions"}}},"description":"organization options","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}},"description":"organization details"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Update organization details","tags":["Organization"]}},"/org/agents":{"get":{"operationId":"getAgents","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Agent"},"type":"array"}}},"description":"array of agents"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get all agents","tags":["Organization"]}},"/org/agents/{agent_id}":{"delete":{"operationId":"removeAgent","parameters":[{"description":"UUID of the agent to remove","in":"path","name":"agent_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"204":{"description":"empty response"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Remove and uninstall an agent","tags":["Organization"]},"get":{"operationId":"getAgent","parameters":[{"description":"UUID of the agent","in":"path","name":"agent_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}},"description":"agent details"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Get details for a single agent","tags":["Organization"]},"patch":{"operationId":"updateAgentSite","parameters":[{"description":"UUID of the agent to update","in":"path","name":"agent_id","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSiteID"}}},"description":"site_id to associate with the agent","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}},"description":"agent details"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Update the site associated with agent","tags":["Organization"]}},"/org/agents/{agent_id}/update":{"post":{"operationId":"upgradeAgent","parameters":[{"description":"UUID of the agent to update","in":"path","name":"agent_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"204":{"description":"empty response"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Force an agent to update and restart","tags":["Organization"]}},"/org/assets":{"get":{"operationId":"getAssets","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Asset"},"type":"array"}}},"description":"array of assets"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get all assets","tags":["Organization"]}},"/org/assets/bulk/clearTags":{"post":{"operationId":"clearBulkAssetTags","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Search"}}},"description":"search query to filter","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/responses/StatusMessage"}}},"description":"status message"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Clear all tags across multiple assets based on a search query","tags":["Organization"]}},"/org/assets/bulk/tags":{"patch":{"operationId":"updateBulkAssetTags","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetTagsWithSearch"}}},"description":"search query to filter and tags to apply","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/responses/StatusMessage"}}},"description":"status message"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Update tags across multiple assets based on a search query","tags":["Organization"]}},"/org/assets/top.hw.csv":{"get":{"operationId":"exportAssetTopHWCSV","responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"top asset hardware platforms and counts as csv"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Top asset hardware products as CSV","tags":["Export"]}},"/org/assets/top.os.csv":{"get":{"operationId":"exportAssetTopOSCSV","responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"top operating systems and counts as csv"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Top asset operating systems as CSV","tags":["Export"]}},"/org/assets/top.tags.csv":{"get":{"operationId":"exportAssetTopTagsCSV","responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"top asset tags and counts as csv"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Top asset tags as CSV","tags":["Export"]}},"/org/assets/top.types.csv":{"get":{"operationId":"exportAssetTopTypesCSV","responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"top asset types and counts as csv"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Top asset types as CSV","tags":["Export"]}},"/org/assets/{asset_id}":{"delete":{"operationId":"removeAsset","parameters":[{"description":"UUID of the asset to remove","in":"path","name":"asset_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"204":{"description":"empty response"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Remove an asset","tags":["Organization"]},"get":{"operationId":"getAsset","parameters":[{"description":"UUID of the asset to retrieve","in":"path","name":"asset_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}},"description":"asset details"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Get asset details","tags":["Organization"]}},"/org/assets/{asset_id}/comments":{"patch":{"operationId":"updateAssetComments","parameters":[{"description":"UUID of the asset to update","in":"path","name":"asset_id","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetComments"}}},"description":"comments to apply to the asset","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}},"description":"asset details"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Update asset comments","tags":["Organization"]}},"/org/assets/{asset_id}/tags":{"patch":{"operationId":"updateAssetTags","parameters":[{"description":"UUID of the asset to update","in":"path","name":"asset_id","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetTags"}}},"description":"tags to apply to the asset","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}},"description":"asset details"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Update asset tags","tags":["Organization"]}},"/org/key":{"delete":{"operationId":"removeKey","responses":{"204":{"description":"empty response"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Remove the current API key","tags":["Organization"]},"get":{"operationId":"getKey","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKey"}}},"description":"api key details"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get API key details","tags":["Organization"]}},"/org/key/rotate":{"patch":{"operationId":"rotateKey","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKey"}}},"description":"api key details"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Rotate the API key secret and return the updated key","tags":["Organization"]}},"/org/services":{"get":{"operationId":"getServices","parameters":[{"description":"an optional search string for filtering results","in":"query","name":"search","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Service"},"type":"array"}}},"description":"array of services"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get all services","tags":["Organization"]}},"/org/services/subnet.stats.csv":{"get":{"operationId":"exportSubnetUtilizationStatsCSV","parameters":[{"description":"an optional subnet mask size (ex:24)","in":"query","name":"mask","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"subnet utilization stats as csv"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Subnet utilization statistics as as CSV","tags":["Export"]}},"/org/services/top.products.csv":{"get":{"operationId":"exportServicesTopProductsCSV","responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"top service products and counts as csv"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Top service products as CSV","tags":["Export"]}},"/org/services/top.protocols.csv":{"get":{"operationId":"exportServicesTopProtocolsCSV","responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"top service protocols and counts as csv"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Top service protocols as CSV","tags":["Export"]}},"/org/services/top.tcp.csv":{"get":{"operationId":"exportServicesTopTCPCSV","responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"top TCP services and counts as csv"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Top TCP services as CSV","tags":["Export"]}},"/org/services/top.udp.csv":{"get":{"operationId":"exportServicesTopUDPCSV","responses":{"200":{"content":{"text/csv":{"schema":{"format":"binary","type":"string"}}},"description":"top UDP services and counts as csv"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Top UDP services as CSV","tags":["Export"]}},"/org/services/{service_id}":{"delete":{"operationId":"removeService","parameters":[{"description":"UUID of the service to remove","in":"path","name":"service_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"204":{"description":"empty response"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Remove a service","tags":["Organization"]},"get":{"operationId":"getService","parameters":[{"description":"UUID of the service to retrieve","in":"path","name":"service_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Service"}}},"description":"service details"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":"Get service details","tags":["Organization"]}},"/org/sites":{"get":{"operationId":"getSites","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Site"},"type":"array"}}},"description":"array of sites"},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"security":[{"bearerAuth":[]}],"summary":"Get all sites","tags":["Organization"]},"put":{"operationId":"createSite","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteOptions"}}},"description":"site definition","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Site"}}},"description":"site details"},"401":{"$ref":"#/components/responses/UnauthorizedError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"security":[{"bearerAuth":[]}],"summary":