> ## Documentation Index > Fetch the complete documentation index at: https://docs.gc.ai/llms.txt > Use this file to discover all available pages before exploring further. # Update the Company Profile > Partially update the organization's company profile. Omitted fields are left unchanged; nullable fields accept `null` to clear them. Requires an **org-scoped** key (`gcai_...`): company context is organization-level configuration, so user-scoped keys receive 403. Creating the first company profile is done in the web UI. ## OpenAPI ````yaml PATCH /company-profile openapi: 3.0.3 info: title: GC AI External API version: 1.0.0 description: >- The GC AI External API allows programmatic access to GC AI's chat capabilities. It's designed for integration with workflow automation tools like Zapier, Make, n8n, or custom applications. ## Authentication All API requests must include an API key in the `Authorization` header: ``` Authorization: gcai_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ``` API keys can be created in the GC AI app under **Settings → API**. ## Multi-turn Conversations Conversations can span multiple turns: pass the `chat_id` returned by a completion back on your next request to continue the same chat. See [Multi-turn Conversations](/api-reference/concepts/multi-turn). ## Current Limitations The following is not yet available via API: - **Interactive clarification**: the model cannot pause to ask the caller a follow-up question; the `askUserQuestions` tool is disabled on the API surface ## Usage Usage is tracked and viewable in the GC AI app under **Settings → API → View Usage**. ## Support For API support, contact [support@gc.ai](mailto:support@gc.ai) or reach out to your account representative. contact: email: support@gc.ai servers: - url: https://app.gc.ai/api/external/v1 description: Production server security: [] tags: - name: Async Jobs description: Poll the status and result of asynchronous API jobs - name: Chat description: AI chat completion endpoints - name: Files description: File upload and management endpoints - name: Folders description: Folder management endpoints - name: Playbooks description: Playbook review endpoints - name: Profiles description: Personal and company profile endpoints - name: Projects description: Project management endpoints - name: Skills description: Skill library management endpoints - name: Utility description: Health check and connectivity endpoints - name: Usage description: Usage and credit/billing reporting endpoints paths: /company-profile: patch: tags: - Profiles summary: Update the company profile description: >- Partially update the organization's company profile. Omitted fields are left unchanged; nullable fields accept `null` to clear them. Requires an **org-scoped** key (`gcai_...`): company context is organization-level configuration, so user-scoped keys receive 403. Creating the first company profile is done in the web UI. operationId: updateCompanyProfile requestBody: required: false content: application/json: schema: $ref: '#/components/schemas/UpdateCompanyProfileRequest' responses: '200': description: The updated company profile content: application/json: schema: $ref: '#/components/schemas/CompanyProfileResponse' '400': description: No fields provided, or invalid request body content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Missing or malformed API key content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Key is not org-scoped, or the API key is invalid content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: No company profile exists to update content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: >- The organization has more than one company profile, so the singular `/company-profile` resource cannot disambiguate. Manage multiple companies in the web UI. content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: >- Rate limit exceeded. See [Rate Limits](/api-reference/concepts/rate-limits) for the tiers, limits, and how to back off. headers: Retry-After: schema: type: string description: Seconds to wait before retrying after a rate-limit block. example: '60' required: true description: Seconds to wait before retrying after a rate-limit block. RateLimit-Limit: schema: type: string description: Request quota for the applicable window. example: '3' required: true description: Request quota for the applicable window. RateLimit-Remaining: schema: type: string description: Requests remaining in the current window. example: '0' required: true description: Requests remaining in the current window. RateLimit-Reset: schema: type: string description: Seconds until the quota resets. example: '60' required: true description: Seconds until the quota resets. content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: Service temporarily unavailable headers: Retry-After: schema: type: string description: >- Seconds to wait before retrying after a transient service outage. example: '5' required: true description: >- Seconds to wait before retrying after a transient service outage. content: application/json: schema: $ref: '#/components/schemas/Error' security: - ApiKeyAuth: [] components: schemas: UpdateCompanyProfileRequest: type: object properties: name: type: string minLength: 1 description: Company name (cannot be cleared) dba_name: type: string nullable: true description: Doing-business-as name. Send null to clear. industry: type: string nullable: true description: Industry sector. Send null to clear. size: type: string nullable: true description: Company size band. Send null to clear. location: type: string nullable: true description: Primary office location. Send null to clear. incorporation_country: type: string nullable: true description: Country of incorporation. Send null to clear. incorporation_state: type: string nullable: true description: State/province of incorporation. Send null to clear. description: type: string nullable: true description: Short company description. Send null to clear. revenue: type: string nullable: true description: Annual revenue band. Send null to clear. legal_matters: type: string nullable: true description: Typical legal matters. Send null to clear. regulations: type: string nullable: true description: Key regulations. Send null to clear. risk_tolerance: type: string nullable: true description: Risk tolerance level. Send null to clear. additional_info: type: string nullable: true description: Free-form additional context. Send null to clear. customer_types: type: array nullable: true items: type: string description: Types of customers served. Send null or [] to clear. CompanyProfileResponse: type: object properties: id: type: string format: uuid description: Unique company profile identifier name: type: string description: Company name dba_name: type: string nullable: true description: Doing-business-as name, or null industry: type: string nullable: true description: Industry sector, or null size: type: string nullable: true description: Company size band (e.g. "51-200"), or null location: type: string nullable: true description: Primary office location, or null incorporation_country: type: string nullable: true description: Country of incorporation, or null incorporation_state: type: string nullable: true description: State/province of incorporation, or null description: type: string nullable: true description: Short company description, or null revenue: type: string nullable: true description: Annual revenue band, or null legal_matters: type: string nullable: true description: Typical legal matters the company handles, or null regulations: type: string nullable: true description: Key regulations the company must comply with, or null risk_tolerance: type: string nullable: true description: Risk tolerance level (e.g. "Low"), or null additional_info: type: string nullable: true description: Free-form additional context for the AI, or null customer_types: type: array nullable: true items: type: string description: Types of customers the company serves, or null created_at: type: string nullable: true description: ISO 8601 creation timestamp updated_at: type: string nullable: true description: ISO 8601 last-update timestamp required: - id - name - dba_name - industry - size - location - incorporation_country - incorporation_state - description - revenue - legal_matters - regulations - risk_tolerance - additional_info - customer_types - created_at - updated_at Error: type: object properties: error: type: string description: Error message code: type: string description: >- Machine-readable error code present on some errors (e.g. `RATE_LIMITED`, `INSUFFICIENT_CREDITS`, `TRIAL_NOT_STARTED`, `BILLING_NOT_CONFIGURED`). Branch on this rather than the human-readable `error` string. message: type: string description: Additional error details details: type: object additionalProperties: nullable: true description: Validation error details (for 400 errors) required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization description: |- API key for authentication. Format: `gcai_xxxxxxxxx` Create API keys in the GC AI app under Settings → API. ````