Updating Company Information

Keep your company data accurate for compliance reporting with PATCH /v1/companies/{companyId} (see Getting Started for a full request example). 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:
curl
curl -X PATCH "https://partner-api.sannos.ai/v1/business-entities/$BUSINESS_ENTITY_ID" \
  -H "X-API-Key: $EVE_COMPANY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"EMEA Operations"}'

Updating Compliance Reviews

Update review metadata for better organization:
curl
curl -X PATCH "https://partner-api.sannos.ai/v1/compliance-reviews/$REVIEW_ID" \
  -H "X-API-Key: $EVE_COMPANY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Q1 2024 SOC2 Audit",
    "scope": "Cloud infrastructure and data handling processes"
  }'
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