Atualizar tag

PUT

/simplificav2/tag/:id

Atualiza uma tag existente. Regras: - a operação atualiza somente os campos enviados; - campos omitidos continuam com o valor atual; - use `ativo = "N"` para inativar; - use `ativo = "S"` para reativar; - quando o nome muda, a API propaga a atualização para o campo textual de tags das pessoas da empresa; - a API não possui rota de exclusão para esse cadastro auxiliar. Exemplo de uso: ```http PUT {{base_url}}/simplificav2/tag/12 Authorization: Bearer {{bearer_token}} Content-Type: application/json { "tag": "Cliente premium", "ativo": "S" } ```

Atualizar tag

PUT

/simplificav2/tag/:id

Atualiza uma tag existente.

Regras:

a operação atualiza somente os campos enviados;
campos omitidos continuam com o valor atual;
use ativo = "N" para inativar;
use ativo = "S" para reativar;
quando o nome muda, a API propaga a atualização para o campo textual de tags das pessoas da empresa;
a API não possui rota de exclusão para esse cadastro auxiliar.

Exemplo de uso:

1 PUT {{base_url}}/simplificav2/tag/12
2 Authorization: Bearer {{bearer_token}}
3 Content-Type: application/json
4 
5 {
6   "tag": "Cliente premium",
7   "ativo": "S"
8 }

Authentication

AuthorizationBearer

Token privado usado para consultar dados da plataforma.

Como usar:

obtenha o token privado da sua empresa;
envie Authorization: Bearer SEU_TOKEN_PRIVADO;
não use x-api-key neste módulo.

Path parameters

idintegerRequired

Identificador da tag.

Request

This endpoint expects an object.

tagstring or nullOptional

Novo nome da tag.

ativostring or nullOptional

Novo status da tag. Use S para ativar ou N para inativar.

Response

Tag atualizada com sucesso.

statusstring

mensagemstring

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error

$	curl -X PUT https://gestao.simplificagestao.com.br/ords/gestao/simplificav2/tag/1 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"status": "sucesso",
3	"mensagem": "Solicitação executada com sucesso.",
4	"data": {
5	"id": 1
6	}
7	}

$	curl -X PUT https://gestao.simplificagestao.com.br/ords/gestao/simplificav2/tag/1 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"status": "sucesso",
3	"mensagem": "Solicitação executada com sucesso.",
4	"data": {
5	"id": 1
6	}
7	}

1	PUT {{base_url}}/simplificav2/tag/12
2	Authorization: Bearer {{bearer_token}}
3	Content-Type: application/json
4
5	{
6	"tag": "Cliente premium",
7	"ativo": "S"
8	}