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

# Update person details

> Updates a person's information including contact details and professional information.
      - Contact details (emails/phones) are upserted - existing records are updated, new ones are added
      - Professional details are updated if provided
      - All fields are optional - only provided fields will be updated



## OpenAPI

````yaml PATCH /v0/persons/{id}
openapi: 3.1.0
info:
  title: Stardex API (v0)
  version: 0.0.1
  description: Stardex ATS legacy API.
servers:
  - url: https://api.stardex.ai
    description: Production API server
security:
  - bearerAuth: []
tags: []
paths:
  /v0/persons/{id}:
    patch:
      tags:
        - people
      summary: Update person details
      description: >-
        Updates a person's information including contact details and
        professional information.
              - Contact details (emails/phones) are upserted - existing records are updated, new ones are added
              - Professional details are updated if provided
              - All fields are optional - only provided fields will be updated
      parameters:
        - in: path
          name: id
          required: true
          description: Person ID
          schema:
            type: string
          example: 123e4567-e89b-12d3-a456-426614174000
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/V0UpdatePersonRequest'
            example:
              emails:
                - contact_data_type: work
                  value: john.doe@company.com
                - contact_data_type: personal
                  value: john@gmail.com
              phones:
                - contact_data_type: work
                  value: +1-555-0123
                - contact_data_type: mobile
                  value: +1-555-0124
              current_job_title: Senior Software Engineer
              linkedin_location: San Francisco Bay Area
              linkedin_headline: Building innovative solutions | Tech Lead at Company
              address: 123 Main St, San Francisco, CA 94105
      responses:
        '200':
          description: Successfully updated person
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V0UpdatePersonResponse'
              example:
                error: null
                data:
                  success: true
                  message: Person updated successfully
        '400':
          description: Bad request - invalid data provided
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V0UpdatePersonResponse'
              example:
                error: Invalid request data. Check the request body.
                data: null
        '404':
          description: Person not found or not accessible
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V0UpdatePersonResponse'
              example:
                error: Person not found
                data: null
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V0UpdatePersonResponse'
              example:
                error: Internal server error
                data: null
components:
  schemas:
    V0UpdatePersonRequest:
      type: object
      properties:
        linkedin_url:
          type: string
          description: LinkedIn profile URL (alternative to using person ID)
        emails:
          type: array
          items:
            $ref: '#/components/schemas/ContactValue'
          description: Email addresses to update/add as an array
        phone_numbers:
          type: array
          items:
            $ref: '#/components/schemas/ContactValue'
          description: Phone numbers to update/add as an array
        name:
          type: string
          description: Full name
        first_name:
          type: string
          description: First name
        last_name:
          type: string
          description: Last name
        current_job_title:
          type: string
          description: Current job title
        company_name:
          type: string
          description: Current company name
        linkedin_location:
          type: string
          description: LinkedIn location
        linkedin_headline:
          type: string
          description: LinkedIn headline
        address:
          type: string
          description: Physical address
        enrich_record:
          type: boolean
          description: Whether to enrich the person record
        work_email:
          type: string
          description: Work email address
        personal_email:
          type: string
          description: Personal email address
        mobile_phone:
          type: string
          description: Mobile phone number
        work_phone:
          type: string
          description: Work phone number
    V0UpdatePersonResponse:
      type: object
      properties:
        error:
          type:
            - string
            - 'null'
          description: Error message if any
        data:
          type:
            - object
            - 'null'
          properties:
            success:
              type: boolean
            message:
              type: string
          required:
            - success
            - message
      required:
        - error
        - data
    ContactValue:
      type: object
      properties:
        contact_data_type:
          type:
            - string
            - 'null'
          description: Category of contact (work/personal/etc)
        value:
          type: string
          description: Contact value
      required:
        - contact_data_type
        - value
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Authenticate with a Bearer token: API key, OAuth token, or session
        token.

````