---
title: "Atribuir status ao chat"
method: PATCH
path: "/v1/settings/status"
tags: ["Settings"]
---

# Atribuir status ao chat

`PATCH /v1/settings/status`

## Request

- Base URL: `https://api.liderhub.com.br`
- URL: `https://api.liderhub.com.br/v1/settings/status`
- Auth: API key in header `x-company-key`

Define o **status** (etapa do funil) de um contato.

Aceita **um status por vez** — enviar um novo substitui o anterior.

**Como usar:**
1. Chame `GET /v1/settings/status` e copie o `id` do status desejado.
2. Envie esse `id` no campo `status`, junto com o `contact`.

> O `contact` é o UUID do contato, o mesmo `id` retornado em `GET /v1/contacts`.

## Request body

- UpdateChatStatusDto
  - `contact` string, uuid, required: UUID do contato (mesmo `id` retornado em `GET /v1/contacts`)
  - `status` string, uuid, required: UUID do status — obtenha em `GET /v1/settings/status`

## Response `200`

Status atualizado com sucesso

- UpdateChatStatusResponseDto
  - `contact` string, uuid, required: UUID do contato
  - `status` string, uuid, required: UUID do status agora atribuído ao contato

## Other responses

- `400`: Status inválido ou inexistente no workspace
- `401`: Não autorizado — chave de empresa inválida ou ausente
- `404`: Contato não encontrado neste workspace

## Changes

- **2026-11-03** `45d9c84fa0bc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/liderhub/apis/api-liderhub/changes/v1/settings/status/patch.md)

---

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