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

# Update an Identity

> Update an Identity

Update an identity's name and timezone. You can modify these fields at any time after creation.

<Warning>
  **Identity type cannot be changed**: The `type` field (standard or engagement) is set during creation and cannot be modified via the update endpoint. If you need to change an identity's type, you must:

  1. Delete the existing identity using the [Delete an Identity](/v1/api/identities/delete) endpoint
  2. Create a new identity with the desired type using the [Create an Identity](/v1/api/identities/create) endpoint
</Warning>

<Tip>
  Before deleting an identity to change its type, make sure to:

  * Note any connected integrations (you'll need to reconnect them to the new identity)
  * Consider the impact on any scheduled actions or workflows
  * Be aware that deleting an engagement identity may affect your monthly billing cycle
</Tip>


## OpenAPI

````yaml v1/api/business.json put /identities/{identity_uid}
openapi: 3.1.0
info:
  title: ED's Public API
  description: ED's Public API
  version: 26.622.88
servers:
  - url: https://api.edges.run/v1/
security:
  - APIKeyHeader: []
paths:
  /identities/{identity_uid}:
    put:
      tags:
        - Core
      summary: Update one identity by UID.
      description: Update an Identity
      operationId: update_identity
      parameters:
        - name: identity_uid
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Identity Uid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateIdentityRequestPublic'
            example:
              timezone: Europe/Paris
              name: John Doe
      responses:
        '200':
          description: Identity successfully updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse_IdentityPublic_'
              example:
                uid: 123e4567-e89b-12d3-a456-426614174000
                created_at: '2023-10-01T12:00:00Z'
                workspace_uid: 5678e456-e89b-12d3-a456-426614174001
                name: John Doe
                type: standard
                timezone: Europe/Paris
                is_active: 'false'
                integrations: []
        '400':
          description: Invalid request.
          content:
            application/json:
              examples:
                Identity Management via API is disabled:
                  summary: Identity Management via API Disabled
                  value:
                    message: >-
                      This project does not allow identity management via the
                      API. Please enable it in the project settings.
                    error_label: UPDATE_ONE_IDENTITY_400_BAD_REQUEST
        '403':
          description: Forbidden
          content:
            application/json:
              examples:
                identity_management_disabled:
                  summary: Identity Management Disabled
                  value:
                    message: >-
                      Identity management via the API is not permitted for the
                      current workspace.
                    error_label: UPDATE_ONE_IDENTITY_403_FORBIDDEN
                    params:
                      details: >-
                        To manage identities via the API, enable this feature in
                        the workspace settings under the 'Developers' section of
                        the platform.
        '404':
          description: Not Found
          content:
            application/json:
              example:
                message: Identity not found
                error_label: IDENTITY_404_NOT_FOUND
                params:
                  details: >-
                    Could not find Identity that has
                    uid=5678e456-e89b-12d3-a456-426614174001
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    UpdateIdentityRequestPublic:
      properties:
        name:
          type: string
          minLength: 3
          title: Name
          description: Name of the identity. Must be at least 3 characters long.
        timezone:
          type: string
          title: Timezone
          description: >-
            IANA-compliant timezone identifier used to localize timestamps.
            Follows the IANA time zone database (e.g. America/New_York,
            Europe/London)
          default: Europe/Paris
      additionalProperties: false
      type: object
      required:
        - name
      title: UpdateIdentityRequestPublic
    GenericResponse_IdentityPublic_:
      allOf:
        - $ref: '#/components/schemas/IdentityPublicModel'
      title: GenericResponse[IdentityPublic]
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    IdentityPublicModel:
      properties:
        uid:
          type: string
          format: uuid
          title: Uid
        workspace_uid:
          type: string
          format: uuid
          title: Workspace Uid
        created_at:
          type: string
          format: date-time
          title: Created At
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        timezone:
          type: string
          title: Timezone
        type:
          $ref: '#/components/schemas/IdentityType'
        is_active:
          type: boolean
          title: Is Active
          default: false
        integrations:
          items:
            type: string
          type: array
          title: Integrations
      type: object
      required:
        - workspace_uid
        - timezone
        - type
      title: IdentityPublic
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    IdentityType:
      type: string
      enum:
        - standard
        - engagement
      title: IdentityType
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        API key required for authentication. Add your API key in the X-API-Key
        header.

````