Atualiza um link (o token é imutável)
Atualiza o subId e/ou a URL de destino do link. O token é imutável e não pode ser alterado. A nova URL de destino, quando informada, deve pertencer a um domínio na whitelist da organização. Emite o evento link.updated.
Authorizations
Chave de API (prefixo rstr_) enviada como Authorization: Bearer rstr_....
Path Parameters
Identificador do link (prefixo link_).
^link_[0-9A-HJKMNP-TV-Z]{26}$"link_01J9Z3K7Qn8vYwT2bX4cE6dF8g"
Body
Novo identificador de subcampanha/origem. Envie null para limpar. O token do link é imutável e não pode ser alterado aqui.
1 - 120"youtube-descricao"
Nova URL de destino do redirecionamento. Deve pertencer a um domínio na whitelist da organização. Envie null para voltar ao destino padrão do programa.
"https://loja.exemplo.com/oferta"
Response
Default Response
Identificador único do link (prefixo link_).
"link_01J9Z3K7Qn8vYwT2bX4cE6dF8g"
Identificador da organização dona do link.
"org_01J9Z3K7Qn8vYwT2bX4cE6dF8g"
Identificador do programa ao qual o link pertence.
"prog_01J9Z3K7Qn8vYwT2bX4cE6dF8g"
Identificador do afiliado dono do link.
"aff_01J9Z3K7Qn8vYwT2bX4cE6dF8g"
Token público do link (em minúsculas), único globalmente.
"maria-silva"
Identificador de subcampanha/origem, ou null se não definido.
"instagram-bio"
URL de destino do redirecionamento, ou null quando usa o destino padrão do programa.
"https://loja.exemplo.com/produto"
Indica se este é o link padrão do afiliado (gerado automaticamente).
Situação do link. active: aceita cliques e redireciona. inactive: desativado, não redireciona (token segue reservado por 12 meses).
active, inactive "active"
Data/hora (ISO-8601) em que o link foi desativado, ou null se ativo.
"2026-06-13T12:00:00.000Z"
Data/hora (ISO-8601) de criação do link.
"2026-06-13T12:00:00.000Z"
Data/hora (ISO-8601) da última atualização do link.
"2026-06-13T12:00:00.000Z"
URL pública e clicável do link ({domínio}/t/{token}), já no domínio próprio/primário da organização quando configurado. null/ausente quando a API não tem um domínio base — o cliente usa o fallback local.
"https://go.userepass.com/t/maria-silva"