> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geogen.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Entities update



## OpenAPI

````yaml patch /entities
openapi: 3.1.0
info:
  title: Geogen API
  description: >-
    API for accessing LLM visibility data, managing entities, and tracking AI
    mentions.
  version: 1.0.0
servers:
  - url: https://api.geogen.io/v1
    description: Production server
security:
  - bearerAuth: []
paths:
  /entities:
    patch:
      tags:
        - Entities
      summary: Update Entity
      description: >-
        Update an existing entity's properties such as domain, description,
        language, geolocation, or tracked models. Only the fields provided in
        the request body will be updated.


        **Note:** Entity names cannot be changed directly. Use the `POST
        /entities/name-request` endpoint to submit a name correction request for
        admin review.
      operationId: updateEntity
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - entityId
              properties:
                entityId:
                  type: string
                  description: The ID of the entity to update
                target:
                  type: string
                  description: New website domain (e.g., example.com)
                description:
                  type: string
                  description: New entity description
                language:
                  type: string
                  description: New language code (e.g., 'en', 'fr', 'de')
                geolocation:
                  type: string
                  description: New geolocation code (e.g., 'global', 'us', 'gb')
                models:
                  type: array
                  items:
                    type: string
                  description: >-
                    New array of model UUIDs from /v1/models. Must contain at
                    least 1 model.
            examples:
              update_description:
                summary: Update description
                value:
                  entityId: abc123def456
                  description: Updated description for the entity
              update_domain:
                summary: Update domain
                value:
                  entityId: abc123def456
                  target: newdomain.com
              update_models:
                summary: Update tracked models
                value:
                  entityId: abc123def456
                  models:
                    - model-uuid-1
                    - model-uuid-2
                    - model-uuid-3
      responses:
        '200':
          description: Entity updated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        description: Entity ID
                      name:
                        type: string
                        description: Entity name
                      target:
                        type: string
                        description: Entity domain/URL
                      targetType:
                        type: string
                        enum:
                          - url
                          - term
                        description: Type of target
                      description:
                        type: string
                        description: Entity description
                      language:
                        type: string
                        description: Language code
                      geolocation:
                        type: string
                        description: Geolocation code
                      models:
                        type: array
                        items:
                          type: string
                        description: Selected model UUIDs
                      isActive:
                        type: boolean
                        description: Whether the entity is active
                      createdAt:
                        type: number
                        description: Creation timestamp
                      updatedAt:
                        type: number
                        description: Last update timestamp
                  message:
                    type: string
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Entity not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Domain conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  retryAfter:
                    type: number
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API key authentication. Format: Bearer wsk_your_api_key'

````