Sequences

Update sequence

Update an existing sequence by its encrypted ID

put/v2/sequences/{id}

Request

Base URL: https://api.village.ai
URL: https://api.village.ai/v2/sequences/{id}
Auth: HTTP bearer

Path parameters

idstring required

Encrypted sequence identifier

Example:MLVEUadsfgzdsafsc10q5g%3D%3D!vNnNM

Request body

namestring

descriptionstring nullable

status'draft' | 'active' | 'paused' | 'archived'

Sequence status

ai_instructionsstring

outreach_approach'warm_intro' | 'cold_warm_lever' | 'cold'

leads_last_visitedstring date-time nullable

Example request

{
  "status": "active",
  "ai_email_templates": [
    {
      "id": 1,
      "name": "Ask for Introduction",
      "use_case": "sales",
      "used_for": "Use when you have a warm introducer available",
      "subject": "Quick intro request?",
      "email_body": "Hi {introducer_name}, Hope you're doing well! I'm reaching out..."
    }
  ]
}

Response

Sequence updated successfully

Example response

{
  "data": {
    "id": "MLVEUadsfgzdsafsc10q5g%3D%3D!vNnNM",
    "name": "Cold Outreach – Founders in SaaS",
    "description": "3-step intro sequence for early-stage SaaS founders",
    "status": "active",
    "ai_instructions": "You are a helpful SDR. Keep emails under 120 words...",
    "ai_email_templates": [
      {
        "id": 1,
        "name": "Ask for Introduction",
        "use_case": "sales",
        "used_for": "Use when you have a warm introducer available",
        "subject": "Quick intro request?",
        "email_body": "Hi {introducer_name}..."
      }
    ],
    "total_leads": 25,
    "active_leads": 18,
    "open_rate": 68,
    "reply_rate": 12,
    "click_rate": 8,
    "forward_rate": 3
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.