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

# Relacionamentos

> Endpoints para gestão de pessoas, organizações, territórios e vínculos

## Endpoints de Relacionamento

Base path: `/v1/relationships`

<Note>
  Os endpoints abaixo representam a estrutura planejada. A implementação detalhada e a especificação OpenAPI serão geradas durante o desenvolvimento com FastAPI.
</Note>

## Pessoas

| Método   | Endpoint                                     | Descrição                              |
| -------- | -------------------------------------------- | -------------------------------------- |
| `GET`    | `/v1/relationships/people`                   | Listar pessoas (paginado, com filtros) |
| `POST`   | `/v1/relationships/people`                   | Criar nova pessoa                      |
| `GET`    | `/v1/relationships/people/{id}`              | Obter detalhes de uma pessoa           |
| `PUT`    | `/v1/relationships/people/{id}`              | Atualizar dados de uma pessoa          |
| `DELETE` | `/v1/relationships/people/{id}`              | Remover uma pessoa                     |
| `GET`    | `/v1/relationships/people/{id}/interactions` | Histórico de interações da pessoa      |
| `GET`    | `/v1/relationships/people/{id}/links`        | Vínculos da pessoa no grafo            |

## Organizações

| Método   | Endpoint                               | Descrição                         |
| -------- | -------------------------------------- | --------------------------------- |
| `GET`    | `/v1/relationships/organizations`      | Listar organizações               |
| `POST`   | `/v1/relationships/organizations`      | Criar nova organização            |
| `GET`    | `/v1/relationships/organizations/{id}` | Obter detalhes de uma organização |
| `PUT`    | `/v1/relationships/organizations/{id}` | Atualizar organização             |
| `DELETE` | `/v1/relationships/organizations/{id}` | Remover organização               |

## Territórios

| Método | Endpoint                                    | Descrição                        |
| ------ | ------------------------------------------- | -------------------------------- |
| `GET`  | `/v1/relationships/territories`             | Listar territórios               |
| `POST` | `/v1/relationships/territories`             | Criar novo território            |
| `GET`  | `/v1/relationships/territories/{id}`        | Obter detalhes de um território  |
| `GET`  | `/v1/relationships/territories/{id}/people` | Pessoas vinculadas ao território |

## Vínculos (Grafo)

| Método   | Endpoint                              | Descrição                               |
| -------- | ------------------------------------- | --------------------------------------- |
| `GET`    | `/v1/relationships/links`             | Listar vínculos                         |
| `POST`   | `/v1/relationships/links`             | Criar novo vínculo entre entidades      |
| `DELETE` | `/v1/relationships/links/{id}`        | Remover vínculo                         |
| `GET`    | `/v1/relationships/graph/{entity_id}` | Obter grafo de vínculos de uma entidade |

## Segmentação

| Método | Endpoint                                  | Descrição              |
| ------ | ----------------------------------------- | ---------------------- |
| `GET`  | `/v1/relationships/segments`              | Listar segmentos       |
| `POST` | `/v1/relationships/segments`              | Criar segmento         |
| `GET`  | `/v1/relationships/segments/{id}/members` | Membros de um segmento |
| `GET`  | `/v1/relationships/tags`                  | Listar tags            |
| `POST` | `/v1/relationships/tags`                  | Criar tag              |