PUT
/
api
/
v1
/
organizations
/
{id}
curl --request PUT \
  --url https://app.aegister.com/api/v1/organizations/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-Aegister-Token: <api-key>' \
  --data '{
  "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.",
  "number_employees": 10,
  "website": "https://sample.com",
  "logo": "https://sample.com/logo.svg",
  "sectors": [
    "Agriculture"
  ],
  "industries": [
    "Accounting"
  ],
  "infrastructure": "cloud",
  "contacts": [
    {
      "name": "John Doe",
      "role": "Supervisor",
      "email": "jdoe@mail.com",
      "phone": "3333333333",
      "email_report": true
    }
  ],
  "domains": [
    "sample.com"
  ],
  "ips": [
    "11.22.33.44"
  ]
}'
{
  "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

​
X-Aegister-Token
string
header
required

Path Parameters

​
id
integer
required

Body

​
name
string

Organization common name.

Example:

"Sample Organization"

​
description
string

Organization description

Example:

"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer et posuere erat. Phasellus iaculis metus mauris, quis accumsan felis fermentum at."

​
number_employees
number

Organization number of employees

Example:

10

​
website
string

Full URL of the Organization website

Example:

"https://sample.com"

Full URL reference to Organization Logo file

Example:

"https://sample.com/logo.svg"

​
sectors
enum<string>[]

Sectors in which the Organization operates.

Available options:
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
enum<string>[]

Industries in which the Organization operates.

Available options:
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
​
infrastructure
enum<string>

Organization infrastructure in-use.

Available options:
cloud,
on-prem,
hybrid
​
contacts
object[]

Points of contact for the Organization.

​
domains
string[]

Organization owned domains.

​
ips
string[]

Organization public IPs.

Public IPv4 address.

Response

200
application/json
​
error
integer

Any value different from 0 indicates an error.
More details can be found in messages.

Required range: 0 <= x <= 0
Example:

0

​
messages
any[]

If error is 1, contains zero or more details on the error.

Example:
[]
​
data
object