> ## 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.

# Submit Name Change Request

> Submit a request to correct an entity's display name. Entity names are global shared data and cannot be changed directly. Instead, submit a name correction request that will be reviewed by an admin.

**Limit:** One pending request per entity per workspace.



## OpenAPI

````yaml post /entities/name-request
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/name-request:
    post:
      tags:
        - Entities
      summary: Submit Name Change Request
      description: >-
        Submit a request to correct an entity's display name. Entity names are
        global shared data and cannot be changed directly. Instead, submit a
        name correction request that will be reviewed by an admin.


        **Limit:** One pending request per entity per workspace.
      operationId: submitNameRequest
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - entityId
                - suggestedName
              properties:
                entityId:
                  type: string
                  description: The ID of the entity to request a name change for
                suggestedName:
                  type: string
                  description: The suggested correct name
                reason:
                  type: string
                  description: Optional reason for the name change
            examples:
              basic:
                summary: Request name correction
                value:
                  entityId: abc123def456
                  suggestedName: Correct Company Name
                  reason: The current name has a typo
      responses:
        '201':
          description: Request submitted successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
        '400':
          description: Invalid request or duplicate pending 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'
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'

````