---
title: "Update sequence lead"
method: PUT
path: "/v2/sequences/{sequence_id}/leads/{lead_id}"
tags: ["Sequence Leads"]
---

# Update sequence lead

`PUT /v2/sequences/{sequence_id}/leads/{lead_id}`

## Request

- Base URL: `https://api.village.ai`
- URL: `https://api.village.ai/v2/sequences/{sequence_id}/leads/{lead_id}`
- Auth: HTTP bearer

Update a specific lead in a sequence

## Path parameters

- `sequence_id` string, required: Encrypted sequence identifier
- `lead_id` string, required: Encrypted lead identifier

## Request body

- UpdateLeadRequest: Request to update a sequence lead
  - `status` 'active' | 'not_started' | 'pending' | 'finished' | 'deleted': Status of the lead within the sequence
  - `selected_introducers` object[], nullable
    - `linkedin_identifier` string, required
    - `name` string
    - `rank` integer, required
    - `is_direct` boolean
    - `score` number
  - `next_followup_at` string, date-time, nullable

## Response `200`

Lead updated successfully

- object
  - `data` object, required: Sequence lead with person data and latest activity information
    - `id` string, required: Encrypted lead identifier
    - `sequence_id` string, required: Encrypted sequence identifier
    - `village_person_id` integer, required
    - `status` 'active' | 'not_started' | 'pending' | 'finished' | 'deleted', required: Status of the lead within the sequence
    - `next_followup_at` string, date-time, nullable, required
    - `selected_introducers` object[], nullable, required
      - `linkedin_identifier` string, required
      - `name` string
      - `rank` integer, required
      - `is_direct` boolean
      - `score` number
    - `pipeline_stage` integer, nullable, required
    - `created_at` string, date-time, required
    - `person` object, nullable, required: Person data from PostgreSQL people table for sequences
      - `id` integer, required
      - `first_name` string, nullable, required
      - `last_name` string, nullable, required
      - `full_name` string, nullable, required
      - `linkedin_url` string, uri, nullable, required
      - `linkedin_identifier` string, nullable, required
      - `headline` string, nullable, required
      - `location` object, nullable, required
        - `city` string, nullable, required
        - `state` string, nullable, required
        - `country` string, nullable, required
      - `position` object, nullable, required
        - `title` string, nullable, required
        - `company` object, nullable, required
          - `id` string, nullable, required
          - `name` string, required
          - `linkedin_url` string, uri, nullable, required
          - `domain` string, nullable, required
        - `start_date` string, nullable, required
        - `end_date` string, nullable, required
      - `image_url` string, uri, nullable, required
      - `email` string, email, nullable, required
    - `latest_update` string, nullable, required
    - `latest_update_date` string, date-time, nullable, required
    - `replied` boolean, required
    - `has_next_step` boolean, required
  - `metadata` object, required
    - `request_id` string, required

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - missing or invalid authentication
- `404`: Sequence or lead not found

---

[API](https://skmtc.dev/village/apis/village-v2-api.md) - [All operations](https://skmtc.dev/village/apis/village-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/village/apis/village-v2-api/revisions/aebe21a1a544?raw)