> ## Documentation Index > Fetch the complete documentation index at: https://docs.enginy.ai/llms.txt > Use this file to discover all available pages before exploring further. # Update company fields > Update company fields (standard and custom/AI fields by name). > **Required scope:** `COMPANIES_WRITE` > > **Rate limit:** 30 requests per minute Accepted standard fields (auto-updated): - name - companyUrn - companyLinkedInUrl - website - domain - industry - rangeOfEmployees - numberOfEmployees - yearfounded - description - country - city - streetAddress - hiringOnLinkedIn - phoneNumber - companyEmail - openJobPositions - revenueRange - sixMonthsHeadcountGrowth - twoYearsHeadcountGrowth - yearlyHeadcountGrowth - legalCode - legalName - globalUltimateCode - lastLinkedInPost - googleMapsOpeningHours - taxId Custom/AI fields are also allowed by name and are client-specific. ## OpenAPI ````yaml https://openapi.enginy.ai/definitions.json patch /v1/company/{companyId} openapi: 3.1.0 info: title: Enginy API version: 1.0.0 description: Public API for Enginy platform servers: - url: https://openapi.enginy.ai description: Configured server security: [] tags: - name: AI Variables description: >- Manage AI variables and discover the entity fields you can reference in prompts and entity requests. - name: Inbox description: >- Inbox endpoints for listing contact threads, reading thread messages, managing tags, and sending manual replies. - name: Workflows description: >- Build, validate, publish, run, and inspect advanced (graph) workflows, plus the block/condition catalog needed to author a workflow plan. paths: /v1/company/{companyId}: patch: tags: - Companies summary: Update company fields description: |- Update company fields (standard and custom/AI fields by name). > **Required scope:** `COMPANIES_WRITE` > > **Rate limit:** 30 requests per minute Accepted standard fields (auto-updated): - name - companyUrn - companyLinkedInUrl - website - domain - industry - rangeOfEmployees - numberOfEmployees - yearfounded - description - country - city - streetAddress - hiringOnLinkedIn - phoneNumber - companyEmail - openJobPositions - revenueRange - sixMonthsHeadcountGrowth - twoYearsHeadcountGrowth - yearlyHeadcountGrowth - legalCode - legalName - globalUltimateCode - lastLinkedInPost - googleMapsOpeningHours - taxId Custom/AI fields are also allowed by name and are client-specific. parameters: - schema: type: string description: The company ID required: true description: The company ID name: companyId in: path requestBody: content: application/json: schema: type: object additionalProperties: {} description: >- Fields to update on the company. Supports standard and custom/AI fields by name. Use `GET /v1/companies/fields` (MCP tool `get_company_field_metadata`) to discover valid company field names for `fields`, `include`, `exclude`, and update payloads. examples: basic: summary: Update standard company fields value: name: Acme Inc. website: https://acme.com industry: Software numberOfEmployees: 120 withCustomFields: summary: Update custom/AI fields by name value: companyAiVariable: Key market insight customCompanyField: Value from API clearField: summary: Clear a field using null value: phoneNumber: null responses: '200': description: Company updated successfully content: application/json: schema: type: object properties: status: type: string enum: - success message: type: string data: type: object properties: id: type: number description: Unique identifier for the company appUrl: type: string format: uri description: Direct Enginy app URL for opening this company. name: type: - string - 'null' description: Company name domain: type: - string - 'null' description: Company website domain website: type: - string - 'null' description: Company website URL companyLinkedInUrl: type: - string - 'null' description: Company LinkedIn URL industry: type: - string - 'null' description: Industry sector rangeOfEmployees: type: - string - 'null' description: Range of employees (e.g., "11-50") numberOfEmployees: type: - number - 'null' description: Exact number of employees yearfounded: type: - string - 'null' description: Year the company was founded description: type: - string - 'null' description: Company description country: type: - string - 'null' description: Company country city: type: - string - 'null' description: Company city streetAddress: type: - string - 'null' description: Company street address phoneNumber: type: - string - 'null' description: Company phone number companyEmail: type: - string - 'null' description: Company email address revenueRange: type: - string - 'null' description: Company revenue range hiringOnLinkedIn: type: boolean description: Whether the company is actively hiring on LinkedIn openJobPositions: type: - number - 'null' description: Number of open job positions companyCRMId: type: - string - 'null' description: CRM company ID isCompanyInCRM: type: boolean description: Whether the company is synced with CRM contactsCount: type: number description: >- Number of contacts (leads) associated with this company. lastContactedAt: type: - string - 'null' format: date-time description: >- Date and time of the most recent outbound message sent to any contact at this company across all campaigns. Null when no contacts have been messaged. smartFieldExplanations: type: object additionalProperties: type: string description: >- Map of smart field names to their explanation (returned when smart fields are requested). createdAt: type: string format: date-time description: Date and time when the company was created updatedAt: type: string format: date-time description: Date and time when the company was last updated required: - id - appUrl - name - domain - website - companyLinkedInUrl - industry - rangeOfEmployees - numberOfEmployees - yearfounded - description - country - city - streetAddress - phoneNumber - companyEmail - revenueRange - hiringOnLinkedIn - openJobPositions - companyCRMId - isCompanyInCRM - contactsCount - lastContactedAt - createdAt - updatedAt required: - status - message - data '400': description: Bad request - invalid fields or values '404': description: Company not found security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey in: header name: x-api-key ````