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

# Change Lead Status

> Update a lead's status

## Endpoint

<Card>
  <strong>PUT</strong> `/backend/leads/{id}/status`
</Card>

## Path Parameters

<ParamField path="id" type="string" required>
  Lead ID
</ParamField>

## Body Parameters

<ParamField body="status_id" type="string" required>
  New status ID
</ParamField>

## Request Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X PUT "https://api.leavo.ai/backend/leads/lead-uuid/status" \
    -H "Authorization: Bearer your_api_key_here" \
    -H "Content-Type: application/json" \
    -d '{
      "status_id": "new-status-uuid"
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.leavo.ai/backend/leads/lead-uuid/status', {
    method: 'PUT',
    headers: {
      'Authorization': 'Bearer your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      status_id: 'new-status-uuid'
    })
  });
  ```
</CodeGroup>

## Response

```json theme={null}
{
  "success": true,
  "data": {
    "id": "lead-uuid",
    "name": "John Smith",
    "status": {
      "id": "new-status-uuid",
      "name": "Qualified",
      "color": "#3B82F6"
    },
    "updated_at": "2024-01-15T14:00:00Z"
  }
}
```