Skip to main content
PUT
/
companies
/
{id}
Update Company
curl --request PUT \
  --url https://api.example.com/companies/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "slug": "<string>",
  "industry": "<string>",
  "country": "<string>",
  "timezone": "<string>",
  "currency": "<string>",
  "registration_number": "<string>",
  "tax_id": "<string>",
  "address": "<string>",
  "phone": "<string>",
  "logo_url": "<string>",
  "status": "<string>"
}
'
{
  "success": true,
  "data": {
    "data.id": "<string>",
    "data.name": "<string>",
    "data.slug": "<string>",
    "data.industry": "<string>",
    "data.country": "<string>",
    "data.timezone": "<string>",
    "data.currency": "<string>",
    "data.registration_number": "<string>",
    "data.tax_id": "<string>",
    "data.address": "<string>",
    "data.phone": "<string>",
    "data.logo_url": "<string>",
    "data.status": "<string>",
    "data.settings": {},
    "data.created_at": "<string>",
    "data.updated_at": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Falasefemi2/companyflow/llms.txt

Use this file to discover all available pages before exploring further.

Update an existing company’s information. Supports both PUT and PATCH methods. All fields are optional.

​
Path Parameters

​
id
string
required
Company UUID

​
Request Body

All fields are optional. Only include fields you want to update.
​
name
string
Company name (2-255 characters)
​
slug
string
Unique company identifier (2-255 characters)
​
industry
string
Industry sector (max 100 characters)
​
country
string
Country location (max 100 characters)
​
timezone
string
Timezone identifier (max 50 characters)
​
currency
string
Currency code (max 10 characters)
​
registration_number
string
Business registration number (max 100 characters)
​
tax_id
string
Tax identification number (max 100 characters)
​
address
string
Physical address
​
phone
string
Contact phone number (max 100 characters)
​
logo_url
string
URL to company logo
​
status
string
Company status. One of: active, suspended, inactive

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
The updated company object
​
data.id
string
Company UUID
​
data.name
string
Company name
​
data.slug
string
Company slug identifier
​
data.industry
string
Industry sector
​
data.country
string
Country location
​
data.timezone
string
Timezone identifier
​
data.currency
string
Currency code
​
data.registration_number
string
Registration number
​
data.tax_id
string
Tax identification
​
data.address
string
Physical address
​
data.phone
string
Contact phone
​
data.logo_url
string
Logo URL
​
data.status
string
Company status
​
data.settings
object
Company settings (JSON)
​
data.created_at
string
Creation timestamp (ISO 8601)
​
data.updated_at
string
Last update timestamp (ISO 8601)

​
Request Examples

cURL
curl -X PUT https://api.companyflow.com/companies/123e4567-e89b-12d3-a456-426614174000 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corporation Ltd",
    "industry": "Technology & Software",
    "phone": "+1-555-0199"
  }'

​
Response Example

200 OK
{
  "success": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Acme Corporation Ltd",
    "slug": "acme-corp",
    "industry": "Technology & Software",
    "country": "United States",
    "timezone": "America/New_York",
    "currency": "USD",
    "registration_number": "123456789",
    "tax_id": "98-7654321",
    "address": "123 Main St, New York, NY 10001",
    "phone": "+1-555-0199",
    "logo_url": "https://example.com/logo.png",
    "status": "active",
    "settings": null,
    "created_at": "2026-03-03T10:00:00Z",
    "updated_at": "2026-03-03T14:30:00Z"
  }
}
400 Bad Request
{
  "success": false,
  "message": "invalid company id"
}
400 Validation Error
{
  "success": false,
  "message": "invalid request body"
}
500 Internal Server Error
{
  "success": false,
  "message": "internal server error"
}

​
Error Responses

Status CodeDescription
400Invalid company ID format or invalid request body
500Internal server error

Build docs developers (and LLMs) love

Get started for freeTalk to us