PUT https://app.alaaqat.com/api/companies/{company_id}
Where company_id is the company's _id. Changes the property values you send and leaves the others as they are. Your API key needs the company-update ability, and the team member who created the key needs Edit Company Information.
{
"Accept": "application/json",
"Content-Type": "application/json"
}
The same property values as Create a Company: each key is a property's internal_name, and each value must match its type. Send only the properties you want to change. To empty a value, send null.
{
"num_employees": 52,
"lifecycle_stage": "customer",
"city": "Amman"
}
If a property you send is a unique key, its value must not already belong to another company. Otherwise nothing is updated, and the request is refused with 422 with the error reported on that field.
200 OK, with the whole company under data.
{
"data": {
"properties": {
"_id": "6655a1b2c3d4e5f6a7b8c901",
"name": "Blue Harbor Trading",
"website_url": "https://blueharbor.example.com",
"industry": "Wholesale",
"city": "Amman",
"country_region": "Jordan",
"phone": "96265000000",
"num_employees": 52,
"lifecycle_stage": "customer",
"owner": 12,
"created_by": 12,
"updated_at": "2026-10-21T08:40:12.000000Z",
"created_at": "2026-10-20T09:30:00.000000Z"
},
"account_id": 1024
},
"message": "Entity was modified successfully."
}
| Status | Meaning |
|---|---|
| 403 | The team member who created the key can only change the companies they or their teams own, and this one isn't. |
| 404 | No company with this _id in your account. |
| 422 | A value does not match its property's type, a field that Alaaqat sets was sent, or a unique key value is already taken. |