API Documentation
Endpoints
- Aegister Threat Blocker
- Cloud Defender
- Cyber Assurance
- Documents
- Notifications
- Organizations
- Organization
- Users
- Security Frameworks
- Perimeter Protection
- Search
- Assessments
- Log Analysis
- VPN
Delete Organization
Soft delete an Organization.
The authenticated user can delete only an Organization is part of and has Owner priviledges.
curl --request DELETE \
--url https://app.aegister.com/api/v1/organizations/{id} \
--header 'X-Aegister-Token: <api-key>'
{
"error": 0,
"messages": [],
"data": {
"id": 5,
"name": "Sample Organization",
"description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer et posuere erat. Phasellus iaculis metus mauris, quis accumsan felis fermentum at.",
"ips": [
"11.22.33.44"
],
"logo": "https://sample.com/logo.svg",
"domains": [
"sample.com"
],
"website": "https://sample.com",
"sectors": [
"Agriculture"
],
"industries": [
"Accounting"
],
"infrastructure": "cloud",
"number_employees": 10,
"contacts": [
{
"name": "John Doe",
"role": "Supervisor",
"email": "jdoe@mail.com",
"phone": "3333333333",
"email_report": true
}
]
}
}
Authorizations
Path Parameters
Response
Any value different from 0 indicates an error.
More details can be found in messages
.
0 <= x <= 0
0
If error
is 1
, contains zero or more details on the error.
[]
Unique identifier for the Organization.
5
Organization common name.
"Sample Organization"
Short description of the Organization.
"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer et posuere erat. Phasellus iaculis metus mauris, quis accumsan felis fermentum at."
Organization public IPs.
Public IPv4 address.
Organization logo URL.
"https://sample.com/logo.svg"
Organization owned domains.
Organization main website.
"https://sample.com"
Sectors in which the Organization operates.
Agriculture
, Arts & Entertainment
, Business Services
, Construction
, Consumer Discretionary
, Consumer Staples
, Education
, Energy
, Financials
, Health Care
, Hospitality & Tourism
, Information Technology
, Manufacturing
, Materials
, Media
, Public Sector
, Real Estate
, Retail
, Science & Technology
, Telecommunications
, Transportation
, Utilities
Industries in which the Organization operates.
Accounting
, Airlines/Aviation
, Alternative Dispute Resolution
, Alternative Medicine
, Animation
, Apparel/Fashion
, Architecture/Planning
, Arts/Crafts
, Automotive
, Aviation/Aerospace
, Banking/Mortgage
, Biotechnology/Greentech
, Broadcast Media
, Building Materials
, Business Supplies/Equipment
, Capital Markets/Hedge Fund/Private Equity
, Chemicals
, Civic/Social Organization
, Civil Engineering
, Commercial Real Estate
, Computer Games
, Computer Hardware
, Computer Networking
, Computer Software/Engineering
, Computer/Network Security
, Construction
, Consumer Electronics
, Consumer Goods
, Consumer Services
, Cosmetics
, Dairy
, Defense/Space
, Design
, E-Learning
, Education Management
, Electrical/Electronic Manufacturing
, Entertainment/Movie Production
, Environmental Services
, Events Services
, Executive Office
, Facilities Services
, Farming
, Financial Services
, Fine Art
, Fishery
, Food Production
, Food/Beverages
, Fundraising
, Furniture
, Gambling/Casinos
, Glass/Ceramics/Concrete
, Government Administration
, Government Relations
, Graphic Design/Web Design
, Health/Fitness
, Higher Education/Acadamia
, Hospital/Health Care
, Hospitality
, Human Resources/HR
, Import/Export
, Individual/Family Services
, Industrial Automation
, Information Services
, Information Technology/IT
, Insurance
, International Affairs
, International Trade/Development
, Internet
, Investment Banking/Venture
, Investment Management/Hedge Fund/Private Equity
, Judiciary
, Law Enforcement
, Law Practice/Law Firms
, Legal Services
, Legislative Office
, Leisure/Travel
, Library
, Logistics/Procurement
, Luxury Goods/Jewelry
, Machinery
, Management Consulting
, Maritime
, Market Research
, Marketing/Advertising/Sales
, Mechanical or Industrial Engineering
, Media Production
, Medical Equipment
, Medical Practice
, Mental Health Care
, Military Industry
, Mining/Metals
, Motion Pictures/Film
, Museums/Institutions
, Music
, Nanotechnology
, Newspapers/Journalism
, Non-Profit/Volunteering
, Oil/Energy/Solar/Greentech
, Online Publishing
, Other Industry
, Outsourcing/Offshoring
, Package/Freight Delivery
, Packaging/Containers
, Paper/Forest Products
, Performing Arts
, Pharmaceuticals
, Philanthropy
, Photography
, Plastics
, Political Organization
, Primary/Secondary Education
, Printing
, Professional Training
, Program Development
, Public Relations/PR
, Public Safety
, Publishing Industry
, Railroad Manufacture
, Ranching
, Real Estate/Mortgage
, Recreational Facilities/Services
, Religious Institutions
, Renewables/Environment
, Research Industry
, Restaurants
, Retail Industry
, Security/Investigations
, Semiconductors
, Shipbuilding
, Sporting Goods
, Sports
, Staffing/Recruiting
, Supermarkets
, Telecommunications
, Textiles
, Think Tanks
, Tobacco
, Translation/Localization
, Transportation
, Utilities
, Venture Capital/VC
, Veterinary
, Warehousing
, Wholesale
, Wine/Spirits
, Wireless
, Writing/Editing
Organization infrastructure in-use.
cloud
, on-prem
, hybrid
The number of employees currently in organization.
10
Points of contact for the Organization.
Name of the contact.
"John Doe"
Role of the contact.
"Supervisor"
Email address of the contact.
Ensure to set this if phone is empty.
"jdoe@mail.com"
Phone number of the contact.
Ensure to set this if email is empty.
"3333333333"
If true
then will receive automatic emails each week with a report.
If set true
, ensure email value is not empty.
true
curl --request DELETE \
--url https://app.aegister.com/api/v1/organizations/{id} \
--header 'X-Aegister-Token: <api-key>'
{
"error": 0,
"messages": [],
"data": {
"id": 5,
"name": "Sample Organization",
"description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer et posuere erat. Phasellus iaculis metus mauris, quis accumsan felis fermentum at.",
"ips": [
"11.22.33.44"
],
"logo": "https://sample.com/logo.svg",
"domains": [
"sample.com"
],
"website": "https://sample.com",
"sectors": [
"Agriculture"
],
"industries": [
"Accounting"
],
"infrastructure": "cloud",
"number_employees": 10,
"contacts": [
{
"name": "John Doe",
"role": "Supervisor",
"email": "jdoe@mail.com",
"phone": "3333333333",
"email_report": true
}
]
}
}