Atualizar Status do Grupo de Assinantes

---

Introdução

Este recurso altera o status de um grupo de assinantes previamente cadastrado em uma análise cadastral — por exemplo, para inativar um grupo que não deve mais ser utilizado.

O grupo é identificado pela sua chave externa (external_signer_group_key), retornada na criação.

Disponível em

Perfil	Host
Investidor	investor-api

URL base de cada host: Ambientes (Hosts).

Request

ENDPOINT

/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/signer_group/{external_signer_group_key}/status

MÉTODO

PUT

STATUS

202

Request body

Request Body

{
    "status": "inactive"
}

Body params

Campo	Tipo	Descrição	Obrigatório
status	string	Novo status do grupo. Valores típicos: active, inactive	Sim

Response

202 Accepted. A representação atualizada do grupo é retornada no corpo.

Erros

Status	Código	Quando acontece
400	IVR000185	A análise já foi encerrada (aprovada, recusada, concluída ou cancelada)
404	IVR000182	Grupo de assinantes não encontrado
400	IVR000075	Valor de status inválido
400	IVR000211	Não é possível desativar o grupo padrão

Erros de autenticação, permissão e host: veja Erros da API.