---
title: "Set Lead Status"
method: POST
path: "/api/app-auto-gtm/segments/{segment_id}/leads/{lead_id}/status"
tags: ["AppAutoGtm"]
---

# Set Lead Status

`POST /api/app-auto-gtm/segments/{segment_id}/leads/{lead_id}/status`

Set (or clear, with ``status: null``) a lead's manual funnel status.

``lead_id`` is the ``AgentLead.id`` UUID — the same identifier the inbox
thread (``outreach_sent_emails.person_id``) and the leads-list row (``id``)
both carry, so one endpoint serves both surfaces.

## Path parameters

- `segment_id` integer, required
- `lead_id` string, required

## Cookies

- `ex_access` string, nullable
- `ex_org` string, nullable

## Request body

- SetLeadStatusRequest
  - `status` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/explee/apis/explee-api.md) · [All operations](https://skmtc.dev/explee/apis/explee-api/llms.txt) · [OpenAPI document](https://skmtc.dev/explee/apis/explee-api/revisions/0fa0a8fc7b5d?raw)