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

# Update a Contact

> Updates an existing contact by its `contact_id`. Any `tags` list provided **replaces** the existing tags on the contact.



## OpenAPI

````yaml https://api.monaco.com/openapi.json patch /v1/contacts/{contact_id}
openapi: 3.1.0
info:
  title: Monaco Public API
  description: Public API for Monaco
  version: 1.0.0
servers:
  - url: https://api.monaco.com
security: []
paths:
  /v1/contacts/{contact_id}:
    patch:
      tags:
        - Contacts
      summary: Update a Contact
      description: >-
        Updates an existing contact by its `contact_id`. Any `tags` list
        provided **replaces** the existing tags on the contact.
      operationId: update_contact
      parameters:
        - name: contact_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Contact Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContactUpdateRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicItemResponse_ContactResponse_'
              example:
                data:
                  id: con_abc123
                  account_id: acc_def456
                  first_name: Jane
                  last_name: Smith
                  email: jane@acme.com
                  title: VP of Engineering
                  phone_number: +1-555-123-4567
                  linkedin_url: https://linkedin.com/in/janesmith
                  location: San Francisco, CA
                  source: api
                  do_not_contact: false
                  notes: Met at SaaStr 2025
                  scoring:
                    heat_score: Hot
                  tags:
                    - Decision Maker
                  created_at: '2025-06-15T10:30:00Z'
                  updated_at: '2026-04-21T12:00:00Z'
                  custom_field_1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d: economic_buyer
                meta:
                  timestamp: '2026-04-21T12:00:00Z'
        4XX:
          description: Client error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicErrorResponse'
components:
  schemas:
    ContactUpdateRequest:
      properties:
        first_name:
          anyOf:
            - type: string
            - type: 'null'
          title: First Name
          description: First name of the contact
          examples:
            - Jane
        last_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Name
          description: Last name of the contact
          examples:
            - Smith
        email:
          anyOf:
            - type: string
            - type: 'null'
          title: Email
          description: Email address of the contact
          examples:
            - jane@acme.com
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
          description: Job title of the contact
          examples:
            - VP of Engineering
        phone_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Phone Number
          description: Phone number of the contact
          examples:
            - +1-555-123-4567
        linkedin_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Linkedin Url
          description: LinkedIn profile URL
          examples:
            - https://linkedin.com/in/janesmith
        location:
          anyOf:
            - type: string
            - type: 'null'
          title: Location
          description: Location of the contact
          examples:
            - San Francisco, CA
        notes:
          anyOf:
            - type: string
            - type: 'null'
          title: Notes
          description: Notes about the contact
          examples:
            - Met at SaaStr 2025
        do_not_contact:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Do Not Contact
          description: Whether the contact has opted out of outreach
        tags:
          anyOf:
            - items:
                type: string
                format: uuid
              type: array
            - type: 'null'
          title: Tags
          description: Tags for the contact
      additionalProperties: true
      type: object
      title: ContactUpdateRequest
      description: Request body for updating a contact via PATCH.
    PublicItemResponse_ContactResponse_:
      properties:
        data:
          $ref: '#/components/schemas/ContactResponse'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
      type: object
      required:
        - data
      title: PublicItemResponse[ContactResponse]
    PublicErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      type: object
      required:
        - error
      title: PublicErrorResponse
    ContactResponse:
      properties:
        id:
          type: string
          title: Id
          description: Unique identifier for the contact
          examples:
            - con_abc123
        account_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Account Id
          description: ID of the associated account
          examples:
            - acc_def456
        first_name:
          anyOf:
            - type: string
            - type: 'null'
          title: First Name
          description: First name of the contact
          examples:
            - Jane
        last_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Name
          description: Last name of the contact
          examples:
            - Smith
        email:
          anyOf:
            - type: string
            - type: 'null'
          title: Email
          description: Email address of the contact
          examples:
            - jane@acme.com
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
          description: Job title of the contact
          examples:
            - VP of Engineering
        phone_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Phone Number
          description: Phone number of the contact
          examples:
            - +1-555-123-4567
        linkedin_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Linkedin Url
          description: LinkedIn profile URL
          examples:
            - https://linkedin.com/in/janesmith
        location:
          anyOf:
            - type: string
            - type: 'null'
          title: Location
          description: Location of the contact
          examples:
            - San Francisco, CA
        source:
          anyOf:
            - type: string
            - type: 'null'
          title: Source
          description: Source from which the contact was added
          examples:
            - linkedin
        do_not_contact:
          type: boolean
          title: Do Not Contact
          description: Whether the contact has opted out of outreach
          default: false
        notes:
          anyOf:
            - type: string
            - type: 'null'
          title: Notes
          description: Notes about the contact
          examples:
            - Met at SaaStr 2025
        scoring:
          anyOf:
            - $ref: >-
                #/components/schemas/api__public_api__schemas__contacts__ScoringInfo
            - type: 'null'
          description: Contact scoring information
        tags:
          items:
            type: string
          type: array
          title: Tags
          description: List of tag names associated with the contact
          examples:
            - - Interested
              - Decision Maker
        created_at:
          type: string
          format: date-time
          title: Created At
          description: Date and time the contact was created
          examples:
            - '2025-06-15T10:30:00Z'
        updated_at:
          type: string
          format: date-time
          title: Updated At
          description: Date and time the contact was last updated
          examples:
            - '2025-06-15T10:30:00Z'
        last_activity_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Activity At
          description: >-
            Date and time of the contact's most recent activity (inbound or
            outbound)
          examples:
            - '2025-06-15T10:30:00Z'
        last_activity_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Activity Type
          description: Type of the contact's most recent activity
          examples:
            - outbound_email
        last_outbound_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Outbound At
          description: >-
            Date and time of the most recent outbound interaction with the
            contact
          examples:
            - '2025-06-15T10:30:00Z'
        last_outbound_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Outbound Type
          description: Type of the most recent outbound interaction with the contact
          examples:
            - email
        last_inbound_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Inbound At
          description: >-
            Date and time of the most recent inbound interaction from the
            contact
          examples:
            - '2025-06-15T10:30:00Z'
        last_inbound_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Inbound Type
          description: Type of the most recent inbound interaction from the contact
          examples:
            - email
      additionalProperties: true
      type: object
      required:
        - id
        - created_at
        - updated_at
      title: ContactResponse
      description: >-
        Contact resource. Custom fields appear as additional keys prefixed with
        ``custom_field_``.
    ResponseMeta:
      properties:
        timestamp:
          type: string
          format: date-time
          title: Timestamp
          description: Server timestamp of the response
      type: object
      title: ResponseMeta
    ErrorDetail:
      properties:
        code:
          type: string
          title: Code
          description: Machine-readable error code
          examples:
            - not_found
        message:
          type: string
          title: Message
          description: Human-readable error message
          examples:
            - Resource not found
      type: object
      required:
        - code
        - message
      title: ErrorDetail
    api__public_api__schemas__contacts__ScoringInfo:
      properties:
        heat_score:
          anyOf:
            - type: string
            - type: 'null'
          title: Heat Score
          description: Heat score tier
          examples:
            - Hot
      type: object
      title: ScoringInfo

````