Updating Company Information

Keep your company data accurate for compliance reporting:
PATCH /v1/companies/{companyId}
Recommendations:
  • Update legalName to match official business registration
  • Use ISO 3166-1 alpha-2 codes for country (e.g., “US”, “GB”, “DE”)
  • Include complete address with suite/unit numbers
  • Format phone with country code (e.g., “+1-555-123-4567”)
  • Only provide fields you want to change (partial updates supported)

Updating Business Entities

Rename business entities to reflect organizational changes:
PATCH /v1/business-entities/{businessEntityId}
{
  "name": "EMEA Operations"
}

Updating Compliance Reviews

Update review metadata for better organization:
PATCH /v1/compliance-reviews/{reviewId}
{
  "name": "Q1 2024 SOC2 Audit",
  "scope": "Cloud infrastructure and data handling processes"
}
Note: You cannot change the business entity or framework after creation. To use a different framework, create a new compliance review via document submission.

Data Consistency Tips

  1. Use meaningful names - Include dates, audit types, or department names
  2. Keep scope descriptions detailed - Helps auditors understand coverage
  3. Update immediately - Change names when organizational structure changes
  4. Batch related documents - Submit to the same complianceReviewId for unified analysis