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

# Links (CLI)

> Comandos de links de rastreamento: criação, atualização, ciclo de vida e estatísticas.

O grupo `links` gerencia [links de rastreamento](/docs/conceitos/links-e-cupons): geração, ativação e estatísticas de cliques. A criação é escopada por afiliado, e o rastreamento dos cliques segue o [tracking](/docs/conceitos/tracking) da plataforma.

## Link

```bash theme={null}
# Criar (escopado pelo afiliado)
repass links create aff_xxx --data '{"destinationUrl":"https://loja.exemplo.com/produto","subId":"instagram-bio"}'

# Listar os links de um afiliado (resultado não paginado)
repass links list aff_xxx --json

# Atualizar (parcial; subId: null remove o subId)
repass links update link_xxx --data '{"subId":null}'
```

```text repass links list aff_xxx theme={null}
id       token        subId            destinationUrl                         status  isDefault
-------  -----------  ---------------  -------------------------------------  ------  ---------
link_01  maria-silva  instagram-bio    https://loja.exemplo.com/produto       active  true
```

## Ciclo de vida

```bash theme={null}
repass links deactivate link_xxx   # desativa o link
repass links reactivate link_xxx   # reativa um link desativado
```

<Warning>
  `links deactivate` é `destructive`. Não há reativação equivalente garantida em todo fluxo, então confirme o link certo antes: rode `links stats link_xxx` para ver o volume de tráfego. Em terminal interativo pede confirmação; fora de TTY exige `--yes` (veja [Convenções](/docs/cli/convencoes#modelo-de-risco)).

  ```bash theme={null}
  repass links deactivate link_xxx --yes
  ```
</Warning>

## Estatísticas

```bash theme={null}
repass links stats link_xxx --from 2026-06-01T00:00:00Z --to 2026-07-01T00:00:00Z --json
```

```json repass links stats link_xxx --json theme={null}
{
  "period": { "from": "2026-06-01T00:00:00.000Z", "to": "2026-07-01T00:00:00.000Z" },
  "clicks": { "total": 842, "bots": 12, "converted": 37 }
}
```

<Note>
  Não há `links get` por id: os links são geridos pelo afiliado (`links list`) e por atualização. Para o schema completo de cada corpo (URLs de destino, subId, formato das estatísticas etc.) e os campos dos objetos retornados, consulte a página SDK equivalente ([Links](/docs/sdk/recursos/links)) e a [Referência da API](/docs/convencoes/ids-e-recursos). As regras de negócio estão em [Links e cupons](/docs/conceitos/links-e-cupons) e [Tracking](/docs/conceitos/tracking).
</Note>